Přeskočit na obsah

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

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.

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

Seznam výjimek dostal jeden řádek. Test dostal dva příznaky a zápisy se podmínily:

let dbVerified = false; // pojistka databáze prošla
let 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ý afterAll pomocné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ž beforeAll začíná kontrolou prostředí. Totéž platí pro finally v provozních skriptech.
  • Pravidlo pro háčky: afterAll běží i po chybě v beforeAll. Cokoli v něm se musí umět zeptat „došel beforeAll tak 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 beforeAll za ochranu celého souboru.

Sister bugs / související

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