Přeskočit na obsah

Sériový běh celé testovací sady vyčerpá spojení Postgresu (PrismaClient per soubor)

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

Globální setupFilesAfterEnv soubor (běží v registru každého testovacího souboru):

// 1) strop poolu per klient — jen pro lokální testovací DB
if (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 souboru
const 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 -l roste lineárně s počtem souborů; select count(*) from pg_stat_activity blízko max_connections; chyby začínají až v druhé polovině běhu.
  • Anti-pattern: „singleton“ Prisma klienta přes globalThis jako ochrana — v jestu nefunguje, registr je per soubor; new PrismaClient() v testech bez afterAll(() => prisma.$disconnect()).
  • Lepší přístup: jeden globální setup odpojuje vše; testovací URL s malým connection_limit; globalTeardown navíc ověří, že pg_stat_activity je prázdné (gate).

Sister bugs / související

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