Accueil › Node.js › Reprises, délai exponentiel et disjoncteur
Reprises, délai exponentiel et disjoncteur
L'asynchrone côté serveurintermediaire
Reprendre un appel échoué est utile et dangereux. Trois questions, dans cet ordre.
Est-ce reprenable ?
function reprenable(erreur, methode, cleIdempotence) {
const transitoire =
["ECONNRESET", "ETIMEDOUT", "ECONNREFUSED"].includes(erreur.code) ||
[429, 502, 503, 504].includes(erreur.statut);
if (!transitoire) return false;
const sur = ["GET", "HEAD", "PUT", "DELETE"].includes(methode);
return sur || Boolean(cleIdempotence);
}
Un 400 ne changera jamais d'avis. Et un POST /virements qui a expiré peut
avoir abouti : la reprise créerait un second virement. On ne reprend que ce
qui est sûr.
Combien de temps attendre ?
function delai(tentative) {
const base = Math.min(200 * 2 ** (tentative - 1), 5000); // borné
return base / 2 + Math.random() * (base / 2); // part aléatoire
}
// ≈ 100-200, 200-400, 400-800, 800-1600 ms…
Sans la borne, la sixième tentative attend plus d'une minute. Sans la part aléatoire, mille clients coupés ensemble reviennent ensemble et achèvent le service qui redémarre.
Faut-il encore appeler ?
Quand un service répond mal depuis vingt appels, le vingt-et-unième n'a aucune raison de réussir. Un disjoncteur le fait échouer sans l'émettre : l'appelant est libéré immédiatement, et le service en difficulté cesse de recevoir la charge qui l'empêche de se rétablir.
| État | Comportement | Transition |
|---|---|---|
| fermé | les appels passent | seuil d'échecs atteint → ouvert |
| ouvert | échec immédiat, aucun appel | fenêtre écoulée → entrouvert |
| entrouvert | un appel d'essai | succès → fermé, échec → ouvert |
Les termes à connaître
- Idempotence
Rejouer l'opération produit le même état qu'une seule exécution. Une lecture l'est toujours ; un
POST /paiementsne l'est pas, sauf si le serveur reconnaît une clé fournie par le client.- Erreur transitoire
Une erreur dont la cause peut disparaître seule :
ECONNRESET,ETIMEDOUT, un503, un429. Reprendre a un sens. Un400ou un404ne changeront jamais d'avis.- Délai exponentiel
Le délai double à chaque tentative — 200, 400, 800 ms — et il est borné. Sans borne, la cinquième tentative attendrait plusieurs minutes.
- Part aléatoire
Une variation ajoutée au délai. Sans elle, mille clients coupés au même instant reviennent tous au même instant, et la reprise devient l'attaque.
- Clé d'idempotence
Un identifiant unique envoyé avec l'écriture, que le serveur mémorise. La deuxième tentative portant la même clé renvoie le premier résultat au lieu de créer un doublon.
- Disjoncteur
Un compteur d'échecs qui, passé un seuil, fait échouer les appels sans les émettre. Il protège le service en difficulté et libère l'appelant immédiatement.
- Retry-After
En-tête renvoyé avec un
429ou un503, en secondes ou en date. Quand il est présent, il remplace votre calcul : le serveur sait mieux que vous quand il sera prêt.
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.