Formations — 1 037 leçons en français

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) et THREADPOOL (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.

Lire l'explication détaillée et faire le quiz →

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.