Úklid testu smaže řádek, ale nechá jeho job ve frontě
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Jednotkový test fronty (runDueJobs → „žádný job nesmí selhat“) začal padat s expected 9 to be 0, ačkoli se jeho kód ani testovaná logika nezměnily. Selhání se objevilo jen tehdy, když před ním běžela E2E sada; samostatně a na čisté databázi test procházel. V tabulce jobů zůstávaly čekající joby s chybou „záznam … neexistuje“ a s rostoucím počtem pokusů.
Root cause
Sekce “Root cause”Job ve frontě nese jen ID záznamu, který má zpracovat (zde log odchozího e-mailu). Mezi jobem a záznamem není cizí klíč, protože payload je JSON. Úklidové funkce E2E fixtur mazaly záznamy podle testovacích dat, ale joby nechávaly:
// úklid po testu – smaže logy, joby zůstanouawait prisma.emailLog.deleteMany({ where: { ref_type: "request", ref_id: { in: ids } } });Job tak přežil svůj záznam. Fronta je sdílená a zpracovává všechno, co je na řadě – každý další běh (i v úplně jiném testu) si osiřelé joby vzal, selhal na nich a naplánoval je znovu. Chyba se proto projevila daleko od místa vzniku a vypadala jako nestabilní test.
Přispěly dvě věci: úklid byl rozepsaný na osmi místech (každé mazalo jen „svou“ tabulku) a test fronty počítal selhání všech jobů, ne jen těch, které sám založil.
Fix
Sekce “Fix”Jeden helper, kterým jde veškeré mazání těchto záznamů v testech – nejdřív joby, potom záznamy:
async function dropEmailLogs(where: Prisma.EmailLogWhereInput) { const ids = (await prisma.emailLog.findMany({ where, select: { id: true } })).map((l) => l.id); for (const id of ids) { await prisma.job.deleteMany({ where: { type: "email.send", payload: { path: ["emailLogId"], equals: id } } }); } await prisma.emailLog.deleteMany({ where: { id: { in: ids } } });}Všech osm přímých mazání bylo nahrazeno voláním helperu. Existující osiřelé joby v lokální testovací databázi se jednorázově odstranily skriptem, který pro každý čekající job ověřil, že jeho záznam opravdu neexistuje.
Jak to poznat příště
Sekce “Jak to poznat příště”- Test padá jen v určitém pořadí sad a číslo v chybě odpovídá počtu řádků, které zůstaly po jiné sadě.
- Ve frontě jsou joby s chybou „neexistuje“ a pokusy > 1, starší než právě běžící test.
- Vazba „job → záznam“ vede přes JSON payload, takže ji databáze nehlídá: kdo maže záznam, musí smazat i job.