Formations — 1 037 leçons en français

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 /paiements ne 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, un 503, un 429. Reprendre a un sens. Un 400 ou un 404 ne 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 429 ou un 503, 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.

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.