Accueil › Spring Boot › Résilience : circuit breaker, retry et bulkhead
Résilience : circuit breaker, retry et bulkhead
Microservices avec Spring Cloudavance
Dans un système de microservices, un service lent ou indisponible peut provoquer une panne en cascade : ses appelants attendent, épuisent leurs propres ressources, et deviennent à leur tour indisponibles. Resilience4j (avec le starter io.github.resilience4j:resilience4j-spring-boot3) protège les appels entre services avec des annotations posées sur les méthodes.
Le plus utilisé est le circuit breaker, à trois états : CLOSED (normal), OPEN (appels coupés, repli immédiat) et HALF_OPEN (test progressif du rétablissement).
@Service
public class CatalogueClientService {
@CircuitBreaker(name = "catalogue", fallbackMethod = "produitParDefaut")
public Produit recupererProduit(Long id) {
return catalogueClient.get().uri("/produits/{id}", id).retrieve().body(Produit.class);
}
private Produit produitParDefaut(Long id, Throwable t) {
return Produit.indisponible(id);
}
}
resilience4j:
circuitbreaker:
instances:
catalogue:
failure-rate-threshold: 50 # % d'échecs qui ouvre le circuit
sliding-window-size: 10 # nombre d'appels observés
wait-duration-in-open-state: 10s # avant de tester à nouveau
permitted-number-of-calls-in-half-open-state: 3
La méthode de repli doit avoir les mêmes paramètres, plus un Throwable en dernier, et le même type de retour. D'autres annotations complètent le circuit breaker : @Retry, @Bulkhead, @RateLimiter, @TimeLimiter — chacune protège contre un problème différent, et leur ordre d'application compte.
Les termes à connaître
- Panne en cascade
Quand un service en aval devient lent ou indisponible, les appelants qui attendent sa réponse accumulent des requêtes en attente, épuisent leurs propres ressources (threads, connexions) et deviennent à leur tour indisponibles pour leurs propres appelants. Sans protection, la panne d'un seul service se propage à tout le système.
- @CircuitBreaker
Annotation Resilience4j qui enveloppe un appel : au-delà d'un taux d'échec configuré, elle coupe le circuit (état OPEN) et bascule immédiatement vers une méthode de repli, sans même tenter l'appel, pendant une durée configurée.
- États CLOSED, OPEN, HALF_OPEN
CLOSED : les appels passent normalement, les échecs sont comptabilisés. OPEN : les appels sont immédiatement rejetés (repli direct), aucun appel réel n'est tenté. HALF_OPEN : après le délai d'attente, un nombre limité d'appels est autorisé à titre de test ; leur résultat décide de revenir à CLOSED ou de rouvrir OPEN.
- Méthode de repli (fallbackMethod)
Méthode appelée à la place de l'appel protégé quand celui-ci échoue ou que le circuit est ouvert. Signature attendue : mêmes paramètres que la méthode d'origine, avec en dernier paramètre optionnel un
Throwable(ou un type plus précis), et le même type de retour.- @Retry
Réexécute automatiquement un appel qui a échoué, jusqu'à un nombre maximal de tentatives, avec un délai entre chaque tentative (fixe ou avec attente exponentielle).
- @Bulkhead
Limite le nombre d'appels concurrents vers une dépendance, pour qu'une dépendance lente n'épuise pas toutes les ressources (threads) disponibles au détriment des autres. Deux implémentations :
SEMAPHORE(limite un compteur d'appels concurrents) etTHREADPOOL(isole les appels dans un pool de threads dédié).- @RateLimiter
Limite le nombre d'appels autorisés par unité de temps, indépendamment des échecs — utile pour respecter la limite imposée par une API externe, par exemple.
- @TimeLimiter
Impose une durée maximale à un appel asynchrone (méthode renvoyant un
CompletableFuture, ou un type réactif avec le module d'intégration Reactor) : au-delà, l'appel est considéré en échec, sans attendre indéfiniment.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.