Regresní test povolený podle podřetězce adresy mění výchozí pásmo celé databáze
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Žádný. Test procházel místně i v CI a pracoval nad správnou databází. Vadu našla až revize testu: kdyby adresa ukazovala jinam, test by běžel taky.
Root cause
Sekce “Root cause”Tři věci v jednom souboru.
1. Povolení podle podřetězce.
const hasTestDb = (process.env.DATABASE_URL || "").includes("app_test");const d = hasTestDb ? describe : describe.skip;Podmínce vyhoví i …/produkce?application_name=app_test nebo …/app_test_zaloha. Přísnější kontrola existovala v globálním nastavení testů, ale ta při neshodě jen vynechala vlastní přípravu — jednotlivé soubory nezastavila.
2. Změna nastavení celé databáze. Test ověřoval, že čas zapsaný SQL příkazem nezávisí na pásmu relace. Pásmo přepínal takhle:
await db.$executeRawUnsafe(`ALTER DATABASE "${dbName}" SET timezone TO 'Asia/Tokyo'`);await db.$disconnect(); // nové spojení už má jiné výchozí pásmoTo je zápis do katalogu, který platí pro všechna budoucí spojení všech klientů, dokud ho test nevrátí. dbName se bral z current_database(), tedy z databáze, ke které se test zrovna připojil — ať to byla kterákoli.
3. Úklid bez podmínky. afterAll mazal data a vracel pásmo bez ohledu na to, jestli beforeAll doběhl.
Fix
Sekce “Fix”const TEST_DB = "app_test";const isIsolatedTestDbUrl = (url?: string) => { try { const u = new URL(url ?? ""); return ["127.0.0.1", "localhost"].includes(u.hostname) && u.port === "<port>" && u.pathname === `/${TEST_DB}`; } catch { return false; }};const d = isIsolatedTestDbUrl(process.env.DATABASE_URL) ? describe : describe.skip; // jinak žádné háčky, žádné spojení
let dbVerified = false;beforeAll(async () => { const db = (await prisma.$queryRawUnsafe<{ db: string }[]>(`SELECT current_database() AS db`))[0]?.db; if (db !== TEST_DB) throw new Error(`Test odmítnut: připojená databáze „${db}“ není ${TEST_DB}.`); dbVerified = true; // … fixture});afterAll(async () => { try { if (dbVerified) await cleanup(); } finally { await prisma.$disconnect(); } // odpojení nic nezapisuje → vždy});Pásmo bez zásahu do databáze. Stačí, aby jiné pásmo mělo spojení, kterým běží testovaný kód. PostgreSQL to umí parametrem připojení a Prisma ho předává:
const zonedUrl = `${url}${url.includes("?") ? "&" : "?"}options=${encodeURIComponent("-c TimeZone=Asia/Tokyo")}`;Test si pro tuhle adresu nechá vzniknout vlastního klienta aplikace (oddělený registr modulů), před během ověří current_database() i current_setting('TimeZone') a po něm, že nastavení databáze v katalogu zůstalo stejné.
Jak doložit negativní případ bez databáze
Sekce “Jak doložit negativní případ bez databáze”Skutečné háčky testu se pustí s náhradou databázového klienta, která každé volání zapíše a kromě čtení jména skončí chybou. Tři scénáře: adresa jen s podřetězcem; přesná adresa a databáze ohlásí jiné jméno; přesná adresa a čtení jména selže.
- Nový test: v prvním scénáři žádné volání klienta; ve zbylých dvou jedno čtení jména, žádný zápis, jedno odpojení.
- Starý test ve stejných scénářích: pokus o založení uživatele a v úklidu mazání, bez odpojení.
Dvě věci, na kterých první pokus zkoušky ztroskotal: když se přeskočí všechny testy, nespustí se ani kořenový afterAll (zkouška potřebuje vlastní test); a obal klienta v aplikaci funkce váže přes bind, takže náhrada modelu musí být objekt, ne funkce.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej
.includes(,.match(neboindexOf(nad připojovací adresou v testech aALTER DATABASE/ALTER ROLE/ALTER SYSTEMv testovacím kódu. - Dvě nezávislé kontroly: adresa před připojením (aby se test jinam ani nepřipojil) a identita po připojení (aby nezapisoval, když adresa klame).
- Úklid se ptá na příznak: všechno, co v
afterAllzapisuje, podmiň tím, že kontrola identity prošla. - Nastavení relace místo nastavení databáze:
options=-c …v adrese neboSET LOCALv transakci. Změna na úrovni databáze je sdílený stav, který po pádu testu zůstane. - Ověř, že přepnutí opravdu nastalo: test, který má běžet v jiném pásmu, si pásmo relace přečte a porovná dřív, než cokoli měří.
- Mez: porovnání jména databáze nerozliší jinou databázi stejného jména na stejné adrese. Kde na tom záleží, přidej značku, kterou zapisuje jen příprava testovacího prostředí.
- Anti-pattern: považovat „v CI to běží nad správnou databází“ za pojistku.
Sister bugs / související
Sekce “Sister bugs / související”- Test s pojistkou databáze uklízí i po jejím odmítnutí a chybí v seznamu výjimek CI — stejná rodina: úklid mimo pojistku.
- Dávková úloha s limitem před filtrem — oprava, ke které test patří.
- Živé ověření po nasazení pouští i testy, které sahají do místní databáze
- Jeden sloupec času zapisují dvě konvence — ORM v UTC a raw SQL now() v čase relace