Přeskočit na obsah

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’;

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

Dvě věci, které jednotlivě dávají smysl:

  1. Transakce si na začátku zamkla řádek smlouvy, aby souběžné úhrady nepřepsaly stav:
SELECT status, … FROM "Contract" WHERE id = $1 FOR UPDATE;
  1. 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.

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 čímkoli

Regresní 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 UPDATE a 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_activity jedno spojení ve stavu idle in transaction a 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í”
Přidal aiarchitekt.cz · 16. 11. 2026 1:00
Provozuje aiarchitekt.cz