Zachycená chyba databáze uvnitř transakce — commit se tiše změní v rollback a API hlásí úspěch
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Spárování bankovní platby s fakturou vrátilo HTTP 200 a ID nové platby. V databázi ale nebyla platba, daňový doklad ani změna stavu smlouvy — nic. Zůstal jen jeden vedlejší záznam (seznam materiálu k zakázce), který vznikl přes jiné databázové spojení. V logu serveru byla jedna zalogovaná chyba z navazujícího kroku a žádná chyba z commitu.
Běžné testy to nezachytily: navazující krok v nich buď uspěl, nebo byl nahrazený náhražkou, která vyhazuje výjimku v JavaScriptu. Ta transakci v databázi nezneplatní, takže commit projde.
Root cause
Sekce “Root cause”Navazující krok („po úhradě založ zakázku“) běžel uvnitř platební transakce, obalený tak, aby jeho selhání platbu neshodilo:
await prisma.$transaction(async (tx) => { const payment = await tx.payment.create({ data }); await tx.invoice.update({ where, data: { status: "PAID" } });
try { await runFollowUpRules(tx, contractId); // další zápisy na stejném spojení } catch (e) { console.error("navazující krok selhal", e); // „platbu to nesmí shodit“ } return { paymentId: payment.id };});// → odpověď 200 s paymentIdÚmysl je rozumný, ale platí jen pro chyby vzniklé mimo databázi. Když chybu vyhodí samotný PostgreSQL (porušené omezení, trigger, dělení nulou, zrušený dotaz), přejde transakce do stavu aborted. Od té chvíle:
- každý další příkaz selže s
25P02 current transaction is aborted, COMMITneselže — server ho provede jakoROLLBACKa vrátí jen jiný návratový štítek (ROLLBACKmístoCOMMIT).
Pokud po zachycené chybě už žádný příkaz nenásleduje, callback doběhne normálně, klient pošle COMMIT, databáze všechno zahodí a ORM o tom nic neřekne. Kód za transakcí pokračuje jako po úspěchu.
Co vzniklo přes jiné spojení (jiný klient, jiný pool, externí služba), rollback přežije — proto zbyl osamocený vedlejší záznam.
Fix
Sekce “Fix”Dvě změny, obě nutné:
-
Vedlejší kroky až po commitu. Transakce obsahuje jen to, co musí být atomické (platba, doklad, stav). Z transakce se ven předá jen signál „je co dohnat“; navazující krok se spustí po úspěšném commitu a jeho chyba se loguje, aniž by ovlivnila už uložená data.
-
Kontrola použitelnosti jako poslední příkaz transakce. Kdyby někde hlouběji zůstalo další polykání chyb, levný dotaz na konci callbacku na zneplatněné transakci spadne a chyba se dostane k volajícímu:
const result = await prisma.$transaction(async (tx) => { const payment = await tx.payment.create({ data }); await tx.invoice.update({ where, data: { status: "PAID" } }); if (depositCompleted) pending = { contractId, paidAt };
await tx.$queryRaw`SELECT 1`; // na aborted transakci vyhodí 25P02 return { paymentId: payment.id };});
if (pending) await runFollowUpRulesAfterCommit(pending); // chyba se jen logujeVýsledek: chyba uvnitř finanční transakce vrací 500 a nezůstane nic; chyba navazujícího kroku vrací 200 a platba je skutečně uložená.
Co oprava neřeší: krok po commitu už není atomický s platbou. Když selže nebo proces mezi commitem a krokem spadne, musí existovat dohánění (idempotentní klíč události + opakovaná úloha). To je samostatná práce, ne vedlejší efekt přesunu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej
try/catch(nebo.catch() uvnitř callbacku transakce, kde se chyba jen loguje. U každého se ptej: může uvnitř selhat SQL příkaz na spojení této transakce? Pokud ano, je to tento bug. - Test: poruchu vkládej jako skutečnou chybu databáze na spojení transakce (například
SELECT 1/0nebo dočasný trigger omezený na jeden testovací záznam), ne jako výjimku v JavaScriptu. Ověřuj, že ID z úspěšné odpovědi v databázi opravdu existuje — samotný stavový kód nestačí. - Anti-pattern: „tenhle krok nesmí shodit hlavní zápis“ řešené zachycením výjimky uvnitř transakce. Savepoint (vnořená transakce) by to technicky řešil, ale ne každý ORM ho uvnitř interaktivní transakce nabízí (Prisma nad PostgreSQL ne).
- Lepší přístup: hlavní zápis atomicky, vedlejší účinky po commitu (nebo přes outbox), s idempotentním klíčem a doháněním.
- Pozor na dlouhé transakce: pokud navazující krok volal i externí službu (geokódování, e-mail), držel při tom otevřenou transakci a zámky. Přesun za commit odstraní i tohle.
Sister bugs / související
Sekce “Sister bugs / související”- Zámek FOR UPDATE na rodiči zablokuje INSERT s cizím klíčem z jiného spojení — stejné místo v kódu, druhá past vedlejšího kroku uvnitř transakce.
- Neatomický zápis sady souvisejících řádků — opačný problém: chybí transakce tam, kde má být.
- Prisma interactive transaction — 5s timeout při latenci