Sériový běh celé testovací sady vyčerpá spojení Postgresu (PrismaClient per soubor)
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Celá sada (jest --runInBand, ~630 souborů, z toho stovky integračních nad lokálním Postgresem) skončí
se 151 padajícími soubory a ~600 padajícími testy, ačkoli jednotlivé soubory spuštěné samostatně procházejí.
Chyby jsou různorodé (Prisma „Can’t reach database“, timeouty, prázdné výsledky), teprve psql ukáže
FATAL: sorry, too many clients already. Jest proces po doběhu visí a drží ~100 TCP spojení na DB port.
Root cause
Sekce “Root cause”Jest izoluje každý testovací soubor do vlastního modulového registru a globalThis. Singleton
globalThis.prisma ??= new PrismaClient() v aplikačním kódu tedy vznikne znovu v každém souboru;
k tomu desítky integračních testů zakládají new PrismaClient() přímo. Nikdo nevolá $disconnect().
Výchozí velikost poolu Prisma je num_cpus * 2 + 1, spojení se otevírají lazy, ale nikdy nezavřou —
po ~150 souborech se vyčerpá max_connections = 100 a všechny další DB testy padají na čemkoli.
Fix
Sekce “Fix”Globální setupFilesAfterEnv soubor (běží v registru každého testovacího souboru):
// 1) strop poolu per klient — jen pro lokální testovací DBif (process.env.DATABASE_URL?.includes("localhost:5460") && !/connection_limit=/.test(process.env.DATABASE_URL)) { process.env.DATABASE_URL += (process.env.DATABASE_URL.includes("?") ? "&" : "?") + "connection_limit=4&pool_timeout=30";}// 2) evidence všech klientů založených v tomto souboruconst clients: Array<{ $disconnect: () => Promise<unknown> }> = [];jest.mock("@prisma/client", () => { const actual = jest.requireActual("@prisma/client"); class Tracked extends actual.PrismaClient { constructor(...args: unknown[]) { super(...args); clients.push(this as never); } } return { ...actual, PrismaClient: Tracked };});afterAll(async () => { await Promise.all(clients.splice(0).map((c) => c.$disconnect().catch(() => undefined)));});Po běhu šesti integračních souborů v jednom procesu zůstalo 0 spojení (dřív desítky). Testy, které
@prisma/client mockují samy, mock přepíší — nic se nerozbije; instanceof PrismaClient dál platí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: během běhu sady
lsof -nP -iTCP:<port> -sTCP:ESTABLISHED | wc -lroste lineárně s počtem souborů;select count(*) from pg_stat_activityblízkomax_connections; chyby začínají až v druhé polovině běhu. - Anti-pattern: „singleton“ Prisma klienta přes
globalThisjako ochrana — v jestu nefunguje, registr je per soubor;new PrismaClient()v testech bezafterAll(() => prisma.$disconnect()). - Lepší přístup: jeden globální setup odpojuje vše; testovací URL s malým
connection_limit;globalTeardownnavíc ověří, žepg_stat_activityje prázdné (gate).
Sister bugs / související
Sekce “Sister bugs / související”- Zabitý integrační testovací běh nechá sdílenou test DB v driftu — visící proces se stovkou spojení se musí zabít, čímž vzniká právě tahle past.
- Dev server přes tunel vyčerpá connection limit role — stejná příčina (pool bez stropu), jiný spouštěč.