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.
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.