Přeskočit na obsah

Práce na pozadí v testu drží transakci přes konec souboru a shodí jiný test

import { Aside } from ‘@astrojs/starlight/components’;

Jeden integrační soubor občas selhal celý (všechny testy) na chybě „Transaction already closed … timeout 5000 ms“ hned v přípravě. Samostatně procházel. V úplné sadě procházel také. Selhal jen v některých menších sestavách souborů, a vždy až po téměř dvou minutách.

Dva nesouvisející testy sdílely jeden řádek v databázi:

// routa úpravy záznamu: práce na pozadí, na kterou se nečeká
regenerateDocument(id).catch(logError);
return Response.json({ data });
// uvnitř: dlouhá transakce se sdíleným zámkem na řádku „pojistky“
await db.$transaction(async (tx) => {
await tx.$queryRaw`SELECT … FROM "Gate" WHERE id = 1 FOR SHARE`;
await renderDocument(); // v testovacím prostředí nedoběhlo
}, { timeout: 120_000 });
  • První soubor volal skutečnou routu. Test skončil a prošel, ale tři transakce na pozadí zůstaly otevřené až do svého limitu 120 s.
  • Druhý soubor v přípravě bral stejný řádek FOR UPDATE. Čekal na sdílený zámek déle, než trvá limit jeho vlastní transakce, a selhal.
  • Vada se projevila jen tehdy, když druhý soubor začal ve stejném procesu do 120 s po prvním. Pořadí souborů přitom určuje testovací nástroj (dříve selhané napřed, pak podle délky), ne pořadí argumentů.

Původ ukázal až záznam relací po vteřině: čekající relace s Lock, její blokující PID z pg_blocking_pids a u blokujících stav „idle in transaction“ s časem začátku uvnitř prvního souboru.

V prvním souboru se nahradila jen funkce pozadí, všechno ostatní zůstalo skutečné, a test nově ověřuje, že o ni routa požádala pro správný záznam:

const mockRegenerate = jest.fn(async () => ({ ok: true }));
jest.mock("@/lib/services/document-cache", () => ({
...jest.requireActual("@/lib/services/document-cache"),
regenerateDocument: (id: string) => mockRegenerate(id),
}));
// po úspěšné změně: expect(calls()).toEqual([record.id])
// po odmítnuté změně: expect(calls()).toEqual([])

Oprava se dokládá vynuceným pořadím obou souborů v jednom procesu (vlastní řadič předaný testovacímu nástroji; skutečné pořadí z časů ve výsledku): před opravou druhý soubor 0 z 14 po 113 s čekání, po opravě 14 z 14 za necelou sekundu. Nová kontrola se ověřila mutací — routa bez žádosti o práci na pozadí test shodí.

Samotné nedoběhnutí práce na pozadí v testovacím prostředí tím opravené není; je to samostatná věc.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: hledej v routách volání něco(id).catch(…) bez await a zjisti, zda cíl otevírá transakci nebo bere zámek. Pak najdi testy, které takovou routu volají bez náhrady.
  • Diagnostika: vedle běhu zapisuj relace, které drží transakci déle než pár sekund nebo čekají na zámek, spolu s blokujícími PID. Čas začátku transakce přiřaď k souboru podle časů z výsledku testů.
  • Anti-pattern: zvýšit timeout padajícího testu, vypnout ho nebo ho opakovat do zelené. Příčina je v jiném souboru.
  • Lepší přístup: nahradit jen práci na pozadí a ověřit, že byla vyžádána se správnými argumenty; nebo ji v testu dočkat. Finanční a zámkové ochrany nenahrazovat.
  • Kontrola opravy: pořadí souborů vynutit, ne předpokládat. Úplná sada mohla procházet jen díky jinému složení dávek.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz