Test s pojistkou databáze uklízí i po jejím odmítnutí a chybí v seznamu výjimek CI
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nový regresní test prošel místně cíleně i v úplné sadě. Po odeslání povinná integrační sada v CI selhala: jeden soubor, všechny jeho testy, hlášení „databáze není ve schváleném seznamu testovacích databází“. Předchozí commit byl zelený a kód aplikace s chybou nesouvisel.
Při rozboru se ukázala druhá, závažnější věc, která se sama neprojevila žádnou chybou: po odmítnutí databáze proběhl závěrečný úklid testu.
Root cause
Sekce “Root cause”Dvě chyby v jednom testu.
1. Test nebyl zapsaný mezi výjimky. Projekt má testy, které smějí běžet jen nad schválenou místní databází (pojistka porovná jméno databáze a identifikátor clusteru se seznamem). Běžec sady je na jiném clusteru vynechá a vykáže zvlášť — ale jen ty, které má v seznamu. Nový test pojistku používal, v seznamu nebyl, na runneru tedy běžel a pojistka ho odmítla. Místně je cluster schválený, takže rozdíl nebylo kde uvidět.
2. Úklid běžel i po odmítnutí. Když beforeAll skončí chybou, Jest těla testů nespustí, ale afterAll zavolá:
beforeAll(async () => { await requireTestDb(db); // ← tady to na cizí databázi spadne await cleanup(); original = await readTimezoneOverride();});
afterAll(async () => { try { if (dbName) await restoreTimezone(original); } finally { await cleanup(); // ← nepodmíněně: maže data, dočasně vypíná ochranný trigger await db.$disconnect(); await appDb.$disconnect(); }});Pojistka je „fail-closed“ jen pro těla testů. Úklid stál mimo ni. Na databázi, kterou pojistka právě odmítla, by tedy test mazal a vypínal trigger. Další dvě slabiny téhož bloku:
- kdyby se nepodařilo načíst původní nastavení, obnova by „vrátila“ výchozí hodnotu, kterou nikdy nenačetla — tedy zápis naslepo;
- chyba úklidu nebo prvního odpojení přeskočila odpojení zbylých klientů.
Fix
Sekce “Fix”Seznam výjimek dostal jeden řádek. Test dostal dva příznaky a zápisy se podmínily:
let dbVerified = false; // pojistka databáze prošlalet originalCaptured = false; // původní nastavení je spolehlivě načtené
beforeAll(async () => { await requireTestDb(db); dbVerified = true; await cleanup(); original = await readTimezoneOverride(); originalCaptured = true;});
afterAll(async () => { try { if (dbVerified && originalCaptured) await restoreTimezone(original); } finally { try { if (dbVerified) await cleanup(); } finally { // odpojení nic nezapisuje → vždy, u všech klientů try { await db.$disconnect(); } finally { await appDb.$disconnect(); } } }});Stejná podmínka je i přímo ve funkci, která nastavení databáze mění. Pojistka samotná ani její seznam schválených databází se neměnily a chyba pojistky se ničím nepřekrývá.
Jak doložit negativní případ bez jediného zápisu
Sekce “Jak doložit negativní případ bez jediného zápisu”Odmítnutí nejde bezpečně zkoušet na skutečné cizí databázi. Stačí spustit skutečné háčky testu v Jestu s náhradami:
- pomocný testový soubor nahradí modul pojistky (odmítne), modul úklidu (jen zapíše, že byl volán) a klienta databáze (každý dotaz skončí chybou), a potom testovaný soubor načte přes
require; - konfigurace bez globálního nastavení, adresa databáze nedosažitelná;
- kořenový
afterAllpomocného souboru zapíše pořadí událostí do souboru.
Čtyři scénáře stačí: pojistka odmítne; pojistka projde, ale původní nastavení se nenačte; totéž a úklid selže; pojistka odmítne a první odpojení selže. Před opravou každý z nich ukáže konkrétní nežádoucí volání, po opravě žádné.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej
afterAll/afterEach, které zapisují do databáze bez podmínky, v souborech, jejichžbeforeAllzačíná kontrolou prostředí. Totéž platí profinallyv provozních skriptech. - Pravidlo pro háčky:
afterAllběží i po chybě vbeforeAll. Cokoli v něm se musí umět zeptat „došelbeforeAlltak daleko, aby to bylo bezpečné?“. - Obnova jen z načteného: výchozí hodnota proměnné není „původní stav“. Obnovuj jen to, co jsi prokazatelně přečetl.
- Seznam výjimek hlídej strojově: levná statická kontrola „každý soubor, který volá pojistku, je v seznamu“ by chybu chytila před odesláním.
- Ověř i odmítající prostředí: když se test chová jinak místně a v CI, místní zelená o CI nic neříká. Stačí nasimulovat výběr sad s cizím identifikátorem clusteru.
- Anti-pattern: považovat pojistku na začátku
beforeAllza ochranu celého souboru.
Sister bugs / související
Sekce “Sister bugs / související”- Fronta řazená podle času materializovaného stavu — oprava, ke které tento test patří.
- Živé ověření po nasazení pouští i testy, které sahají do místní databáze — opačný směr téhož rizika.
- Zabitý integrační testovací běh nechá sdílenou test DB v driftu
- Test počítá všechny záznamy sdílené databáze a selže podle data