Formations — 1 037 leçons en français

Accueil › Node.js › Au moins une fois, donc idempotent

Au moins une fois, donc idempotent

Tâches de fond et filesavance

Une file promet de livrer un travail au moins une fois. Pas exactement une fois.

new Worker("courriels", async (travail) => {
  await courriel.envoyer(travail.data.email, "bienvenue");
  // ← ici le processus peut mourir, l'accusé de réception ne part pas
});

Le courriel est parti. L'accusé n'est pas arrivé. La file ne sait pas distinguer « fini sans accusé » de « mort au milieu », donc elle redonne le travail. Le client reçoit deux courriels.

Le doublon arrive quand ça a marché

C'est le point contre-intuitif : le doublon n'est pas la conséquence d'un échec, mais d'une réussite dont l'accusé a échoué. Aucune relecture de code ne le fera disparaître, parce que la faute n'est pas dans le code.

Donc on rend le consommateur idempotent

// une clé stable, dérivée de l'effet voulu
const cle = `bienvenue:${travail.data.userId}`;

try {
  await db.query(
    "insert into effets_courriel (cle) values ($1)", [cle]
  );                                  // ← contrainte d'unicité sur cle
} catch (e) {
  if (e.code === "23505") return;     // déjà fait, on sort sans rien faire
  throw e;
}

await courriel.envoyer(travail.data.email, "bienvenue");

La clé décrit l'effet, pas le travail : deux travaux différents qui veulent le même effet doivent produire la même clé. 23505 est le code PostgreSQL de violation d'unicité.

Ce qu'on ne fait jamais

Espérer que le doublon n'arrive pas. Il arrive, rarement, et précisément le jour où le travail compte — parce que les doublons surviennent pendant les redéploiements et les incidents, c'est-à-dire quand le système est déjà sous tension.

Les termes à connaître

Au moins une fois

La garantie réelle de presque toutes les files : un travail sera livré, peut-être plusieurs fois. Jamais zéro, pas exactement une.

Idempotent

Un traitement qu'on peut appliquer deux fois sans changer le résultat. C'est une propriété du consommateur, pas de la file.

Accusé de réception

Le message par lequel le consommateur dit « j'ai fini ». Sans lui, la file redonne le travail à quelqu'un d'autre.

Clé d'idempotence

Un identifiant stable de l'effet voulu, enregistré avec contrainte d'unicité. La deuxième écriture échoue, et c'est le but.

Verrou sur l'effet

Prendre un verrou nommé par l'effet, et non par le travail, pour empêcher deux exécutions concurrentes du même effet.

Exactement une fois

Une garantie qu'aucune file ne tient entre deux systèmes. Ce qu'on obtient réellement, c'est « au moins une fois » plus un consommateur idempotent.

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.