Souběžné odeslání téhož dokladu projde dvakrát a přečerpá kredit
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Pět souběžných požadavků „odeslat“ na tentýž koncept: dva vrátí 200, kredit se odečte dvakrát a příjemci dostanou zprávy dvakrát. Čtyři různé koncepty odeslané naráz při zbývajícím kreditu 3 projdou všechny.
Root cause
Sekce “Root cause”const doc = await db.doc.findFirst({ where: { id } });if (doc.status !== "DRAFT") throw …; // čteníif (org.used >= org.limit) throw …; // čteníawait db.doc.update({ where: { id }, data: { status: "SENT" } }); // nepodmíněný zápisawait master.org.update({ data: { used: { increment: 1 } } });Mezi čtením a zápisem stihne projít druhý požadavek. Kvóta navíc žije v jiné databázi než doklad, takže to nespojí ani jedna transakce.
Fix
Sekce “Fix”// 1) rezervace kvóty atomickyconst r = await master.org.updateMany({ where: { id, used: { lt: limit } }, data: { used: { increment: 1 } } });if (r.count !== 1) throw new QuotaError();// 2) převzetí konceptu atomickyconst c = await db.doc.updateMany({ where: { id, status: "DRAFT" }, data: { status: "SENT" } });if (c.count !== 1) { await vratRezervaci(); throw new Error("Už bylo odesláno."); }Vedlejší účinky (e-maily, SMS, webhooky) až po úspěšném převzetí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: E2E test, který pošle tutéž akci 5× přes
Promise.alla pak N+1 akcí při zbývající kvótě N; kontroluje počet úspěchů i počitadlo. - Anti-pattern:
find…→if (stav)→updatebez podmínky ve WHERE;incrementpo kontrole přečtené hodnoty. - Lepší přístup: podmíněný
updateMany+ kontrolacount, případněSELECT … FOR UPDATEnebo unikátní idempotenční klíč.
Sister bugs / související
Sekce “Sister bugs / související”Dvojí označení objednávky jako zaplacené, dvojí vystavení faktury po dvojkliku.