Práce na pozadí v testu drží transakci přes konec souboru a shodí jiný test
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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.
Root cause
Sekce “Root cause”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.
Fix
Sekce “Fix”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(…)bezawaita 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í”- Sériový běh celé testovací sady vyčerpá spojení Postgresu — další vada, která se ukáže jen podle toho, co běželo ve stejném procesu předtím.
- Uzavření výstupů podprocesu předbíhá zánik jeho potomků — „test skončil“ neznamená „po testu nic neběží“.