Formations — 1 037 leçons en français

Accueil › Spring Boot › Timeouts, reprises et résilience

Timeouts, reprises et résilience

Appeler et documenter des APIintermediaire

Un appel réseau peut échouer de façon transitoire : un pic de latence, un redémarrage du service distant, une coupure réseau momentanée. Deux réflexes protègent contre ces situations : borner le temps d'attente (timeouts), et retenter automatiquement l'appel dans certains cas (reprises).

Sans timeout explicite, un appel peut attendre indéfiniment. On les configure via une ClientHttpRequestFactory :

@Bean
public RestClient produitApiClient(RestClient.Builder builder) {
    var factory = new SimpleClientHttpRequestFactory();
    factory.setConnectTimeout(2_000); // 2 s pour établir la connexion
    factory.setReadTimeout(5_000);    // 5 s pour recevoir la réponse

    return builder
            .baseUrl("https://api.exemple.com")
            .requestFactory(factory)
            .build();
}

Pour les reprises, Spring Retry (dépendance séparée spring-retry + spring-boot-starter-aop) évite d'écrire une boucle manuelle :

@Retryable(retryFor = ApiIndisponibleException.class, maxAttempts = 3,
           backoff = @Backoff(delay = 500, multiplier = 2))
public Produit appelerApi(Long id) {
    return restClient.get().uri("/produits/{id}", id).retrieve().body(Produit.class);
}

@Recover
public Produit repli(ApiIndisponibleException e, Long id) {
    return Produit.indisponible(); // valeur de repli après épuisement des tentatives
}

Règle importante : ne retenter que des opérations idempotentes (rejouables sans effet de bord, comme un GET) et des erreurs transitoires (timeout, 5xx, connexion refusée) — jamais une erreur 4xx, qui a peu de chances de disparaître au prochain essai.

Les termes à connaître

Timeout de connexion / Timeout de lecture

Le timeout de connexion limite le temps d'attente pour établir la connexion TCP avec le serveur distant. Le timeout de lecture limite le temps d'attente entre deux paquets de la réponse, une fois la connexion établie. Les deux doivent être bornés : sans eux, un appel peut rester bloqué indéfiniment, en attente d'un serveur distant lent ou injoignable.

ClientHttpRequestFactory

Interface qui fabrique les requêtes HTTP sous-jacentes utilisées par RestClient (et RestTemplate). C'est sur elle que se configurent les timeouts, puisque ni RestClient ni RestClient.Builder n'exposent de méthode timeout(...) directement.

SimpleClientHttpRequestFactory / JdkClientHttpRequestFactory

Deux implémentations fournies par Spring. SimpleClientHttpRequestFactory s'appuie sur HttpURLConnection du JDK et expose setConnectTimeout(int) / setReadTimeout(int) en millisecondes. JdkClientHttpRequestFactory (Spring Framework 6.1+) s'appuie sur java.net.http.HttpClient : le timeout de connexion se règle en construisant le HttpClient avec HttpClient.newBuilder().connectTimeout(Duration...), le timeout de lecture avec setReadTimeout(Duration) sur la factory.

spring-retry / @EnableRetry

Spring Retry est un projet séparé de Spring Framework (dépendance spring-retry, plus spring-boot-starter-aop car il repose sur des proxies AOP). @EnableRetry, sur une classe @Configuration, active le mécanisme dans l'application.

@Retryable

Posée sur une méthode, relance automatiquement son exécution si elle lève une exception listée. maxAttempts fixe le nombre total de tentatives (la première incluse), backoff définit le délai entre deux tentatives.

@Backoff

Décrit le délai entre deux tentatives d'un @Retryable : delay (délai initial en ms), et optionnellement multiplier pour un backoff exponentiel (le délai est multiplié à chaque nouvel essai) et maxDelay pour le plafonner.

@Recover

Méthode appelée quand toutes les tentatives d'un @Retryable ont échoué, pour fournir une valeur de repli ou lever une exception métier plutôt que l'exception technique d'origine. Sa signature doit commencer par le type d'exception à récupérer, suivi des mêmes paramètres que la méthode @Retryable.

Circuit breaker

Mécanisme qui, après un nombre d'échecs consécutifs vers un service distant, arrête temporairement d'essayer de l'appeler (il « ouvre le circuit ») pour ne pas aggraver la situation ni bloquer des threads sur un service déjà en difficulté. Contrairement à une reprise, qui réagit à un échec ponctuel, le circuit breaker réagit à une tendance. Vu ici en introduction seulement ; Resilience4j est détaillé au niveau avancé.

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.