Zámek FOR UPDATE na rodiči zablokuje INSERT s cizím klíčem z jiného spojení — transakce čeká sama na sebe
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Poslední z několika částečných úhrad měla dokončit zálohu a založit zakázku. Požadavek visel asi 30 sekund a skončil chybou 500 (Transaction already closed … timeout). Platba, doklad i zakázka se vrátily zpět, ale seznam materiálu k zakázce v databázi zůstal. Druhý pokus prošel hned — jen díky tomu, že seznam už existoval a nic se nevkládalo.
Stejná operace jinou cestou kódu (úhrada jedné faktury celou částkou) fungovala, takže to vypadalo jako nahodilé zpomalení.
Root cause
Sekce “Root cause”Dvě věci, které jednotlivě dávají smysl:
- Transakce si na začátku zamkla řádek smlouvy, aby souběžné úhrady nepřepsaly stav:
SELECT status, … FROM "Contract" WHERE id = $1 FOR UPDATE;- Hlouběji ve stejné transakci se volala pomocná funkce, která záměrně zapisuje globálním klientem (jiné spojení z poolu), a vkládala řádek s cizím klíčem na tutéž smlouvu.
INSERT podřízeného řádku si kvůli kontrole cizího klíče bere na řádku rodiče zámek FOR KEY SHARE. Ten je slučitelný se zámkem, který bere běžný UPDATE neklíčových sloupců (FOR NO KEY UPDATE), ale není slučitelný s FOR UPDATE. Vložení tedy čekalo na konec transakce, která zámek drží — a ta čekala (v aplikaci, přes await) na dokončení vložení.
PostgreSQL to jako deadlock nepozná: z jeho pohledu jedno spojení čeká na zámek a druhé je nečinné uvnitř transakce. Smyčku uzavírá až aplikace. Rozsekne ji teprve timeout interaktivní transakce; po rollbacku se zámek uvolní, čekající INSERT doběhne a commitne se sám — odtud osamocený záznam.
Druhá cesta kódu smlouvu jen aktualizovala (slabší zámek), proto se tam vada neprojevila. Testy ji nezachytily, protože zakládání podřízeného záznamu nahrazovaly náhražkou.
Fix
Sekce “Fix”V transakci zůstalo jen to, co musí být atomické, včetně zámku. Navazující krok, který zapisuje jiným spojením, se spouští až po commitu. Timeout, velikost poolu ani typ zámku se neměnily — zvýšení timeoutu by jen prodloužilo čekání.
const pending = await prisma.$transaction(async (tx) => { await tx.$queryRaw`SELECT 1 FROM "Contract" WHERE id = ${id} FOR UPDATE`; // … platba, doklad, stav smlouvy … return completed ? { contractId: id } : null;});if (pending) await runFollowUpRulesAfterCommit(pending); // smí zapisovat čímkoliRegresní test běží se skutečným zakládáním podřízeného záznamu (bez náhražky) a hlídá i dobu prvního pokusu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: najdi všechna
FOR UPDATEa projdi, co se volá mezi zámkem a koncem transakce. Podezřelé je každé volání, které nedostává klienta transakce jako parametr, a každý import globálního klienta v kódu dosažitelném z transakce. - Diagnostika za běhu: během visícího požadavku ukáže
pg_stat_activityjedno spojení ve stavuidle in transactiona druhé čekající na zámek (wait_event_type = Lock);pg_blocking_pids()na čekajícím spojení vrátí to první. Dvě spojení téhož procesu, která se blokují, jsou tento bug. - Anti-pattern: „pomocná funkce si vezme vlastní spojení, aby její zápis přežil rollback“ volaná zevnitř transakce, která drží zámek na souvisejícím řádku.
- Lepší přístup: buď všechno jedním spojením (klient transakce se předává dolů), nebo striktně po commitu. Když je zámek potřeba jen proti souběžné změně stavu a klíč se nemění, stačí
FOR NO KEY UPDATE, který vkládání potomků neblokuje — to je ale změna souběhové ochrany a chce vlastní test. - Test: vedlejší zápisy v integračních testech nenahrazuj náhražkou, pokud běží jiným spojením než testovaná transakce.
Sister bugs / související
Sekce “Sister bugs / související”- Zachycená chyba databáze uvnitř transakce — commit se tiše změní v rollback — stejné místo v kódu, druhá past.
- Odvozený stav přepočítaný ze snapshotu vlastní transakce — proč tam zámek rodiče vůbec je.
- Prisma interactive transaction — 5s timeout při latenci