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(etRestTemplate). C'est sur elle que se configurent les timeouts, puisque niRestClientniRestClient.Buildern'exposent de méthodetimeout(...)directement.- SimpleClientHttpRequestFactory / JdkClientHttpRequestFactory
Deux implémentations fournies par Spring.
SimpleClientHttpRequestFactorys'appuie surHttpURLConnectiondu JDK et exposesetConnectTimeout(int)/setReadTimeout(int)en millisecondes.JdkClientHttpRequestFactory(Spring Framework 6.1+) s'appuie surjava.net.http.HttpClient: le timeout de connexion se règle en construisant leHttpClientavecHttpClient.newBuilder().connectTimeout(Duration...), le timeout de lecture avecsetReadTimeout(Duration)sur la factory.- spring-retry / @EnableRetry
Spring Retry est un projet séparé de Spring Framework (dépendance
spring-retry, plusspring-boot-starter-aopcar 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.
maxAttemptsfixe le nombre total de tentatives (la première incluse),backoffdé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 optionnellementmultiplierpour un backoff exponentiel (le délai est multiplié à chaque nouvel essai) etmaxDelaypour le plafonner.- @Recover
Méthode appelée quand toutes les tentatives d'un
@Retryableont é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é.
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.