Odvozený stav přepočítaný ze snapshotu vlastní transakce (ztracená aktualizace při souběhu)
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Předpis 400 dostane dva souběžné příjmy po 200. Oba se uloží, součet příjmů v DB je 400, ale uložený odvozený stav předpisu zůstane „částečně uhrazeno“. Navazující dávkový job (zánik členství při nezaplacení) pak takový záznam vyhodnotí jako dluh a ukončí správně zaplacené členství. Druhá varianta téže chyby: jeden nepřiřazený příjem se dvěma souběžnými „přiřaď k předpisu“ dostane ke dvěma předpisům — oba skončí „zaplaceno“, jeden z nich s nulou příjmů.
Root cause
Sekce “Root cause”Služba „zaeviduj příjem“ byla ve své transakci: INSERT příjmu → SELECT předpis + všechny příjmy → výpočet stavu → UPDATE předpis SET status. Při READ COMMITTED vidí každá transakce jen svůj vlastní nový řádek, ne nezacommitovaný řádek té druhé. Obě spočítají 200/400 a obě uloží „částečně“; poslední zápis vyhraje. U přiřazení příjmu bylo findUnique(receipt) + kontrola payment_id IS NULL + bezpodmínečné UPDATE receipt SET payment_id — dvě transakce prošly kontrolou současně.
// před: čtení bez zámku, pak zápisconst p = await tx.payment.findUnique({ where: { id }, include: { receipts: true } });const s = settle(p.receipts); // každá tx vidí jen svůj příjemawait tx.payment.update({ data: { status: s.status } });Fix
Sekce “Fix”Jeden sdílený zámek agregátu, braný PŘED prvním čtením ve všech finančních mutacích (příjem, přiřazení, prominutí, zrušení, refundace, přepočet) i v jobech, které podle stavu rozhodují (zánik si kandidáty přepočítá pod zámkem). Nárok na sdílený řádek jako podmíněný UPDATE:
async function lockPayment(tx, id) { await tx.$executeRaw`SELECT pg_advisory_xact_lock(${hash("payment", id)})`; }
// příjemawait lockPayment(tx, paymentId); // druhá tx tu čeká, pak už vidí oba příjmy… INSERT příjem, SELECT, settle(), UPDATE …
// přiřazeníconst claimed = await tx.paymentReceipt.updateMany({ where: { id: receiptId, payment_id: null }, data: { payment_id: paymentId } });if (claimed.count !== 1) throw new HttpError(409, "Příjem už je přiřazen.");Pořadí zámků je jediné (zámek předpisu, pak podmíněný UPDATE řádku) — žádný cyklus, žádný deadlock. Advisory xact lock je v téže transakci reentrantní, takže vnořený přepočet funguje.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: test se dvěma skutečnými transakcemi a bariérou hned po DB čtení (obalit klienta transakce proxy, která po
findUniquepočká na druhého účastníka). Na chybném kódu obě dojdou k bariéře a přepíší se; na opraveném druhá stojí na zámku a bariéra vyprší timeoutem. - Anti-pattern: „read → compute → write“ odvozeného stavu bez zámku rodiče;
find+if (!row.owner) update(row)místoUPDATE … WHERE owner IS NULL. - Lepší přístup: odvozený stav počítat vždy pod zámkem agregátu (nebo ho nepersistovat a počítat při čtení), nároky dělat podmíněným zápisem a kontrolovat
count.
Sister bugs / související
Sekce “Sister bugs / související”- Podmínka přechodu stavu čtená mimo zámek (stejný agregát, jiné místo): aktivace členství kontrolovala „předpis je zaplacený“ a zámek brala jen pro stavy, které musela přepočítat (
ceka/castecne). U už zaplaceného předpisu použila nezamčené čtení; souběžná refundace celé částky commitla mezi čtením a commitem aktivace a vznikl aktivní člen se stavemceka. Pravidlo: v přechodové transakci (aktivace, zánik, uzavření) zamkni dotčené agregáty před prvním autoritativním čtením bez ohledu na jejich stav, znovu načti a vyhodnoť, zámek drž do commitu. „Rychlá cesta pro už hotový stav“ je přesně díra, kterou souběh najde. - Neatomický zápis souvisejících řádků (stejná rodina: souběh bez zámku rodiče).
- Cron s persistovaným stavem, který přežije editaci — dávkový job rozhoduje podle uloženého stavu, proto musí být stav konzistentní, nebo si ho job přepočítá pod zámkem.