next build na stroji s mnoha jádry vyčerpá PostgreSQL – workery × výchozí pool Prismy > max_connections
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Lokální build gate před nasazením najednou padá, ačkoli lint, typecheck i 220 unit testů prošly:
Generating static pages using 17 workers (19/78)prisma:error Invalid `prisma.event.findMany()` invocation:Too many database connections opened: FATAL: sorry, too many clients alreadyError occurred prerendering page "/de"⨯ Next.js build worker exited with code: 1Na předchozím stroji (8 jader, 7 workerů) stejný projekt stavěl bez problémů. Výstup navíc obsahuje nesouvisející varování (Turbopack „dynamic filesystem access“), které svádí k hledání jinde.
Root cause
Sekce “Root cause”Dvě škálování se násobí: Next.js spouští prerender workery podle počtu jader (18 jader → 17 workerů) a Prisma bez connection_limit v URL otevře pool počet_fyzických_CPU × 2 + 1 spojení na proces (18 jader → 37). 17 × 37 = 629 potenciálních spojení proti max_connections = 100 (výchozí PostgreSQL, k tomu dev server a testy). Pool se plní líně, takže pád přijde až uprostřed generování statických stránek.
Fix
Sekce “Fix”Velikost poolu se odvozuje od fáze, explicitní hodnota v URL vyhrává:
export function withPoolDefaults(url: string, phase: string | undefined): string { if (!url || !/^postgres(ql)?:\/\//.test(url)) return url; if (/[?&]connection_limit=/.test(url)) return url; const limit = phase === "phase-production-build" ? 3 : 10; return `${url}${url.includes("?") ? "&" : "?"}connection_limit=${limit}`;}
// src/lib/db.tsnew PrismaClient({ datasourceUrl: withPoolDefaults(process.env.DATABASE_URL ?? "", process.env.NEXT_PHASE) });17 workerů × 3 = 51 spojení při buildu; za běhu jeden proces × 10. Unit test pokrývá build fázi, běh, zachování existujících parametrů i explicitní limit.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -L connection_limit .env*u projektů s Prismou;SHOW max_connectionsvs.nproc; v logu buildu počet workerů („using N workers“). - Anti-pattern:
DATABASE_URLbez parametrů poolu + prerender, který při buildu čte z databáze; diagnostika podle prvního varování ve výstupu místo prvníhoError. - Lepší přístup: pool podle fáze (build malý, runtime podle počtu procesů), případně
experimental.cpusvnext.configpro omezení workerů a PgBouncer před databází u větších nasazení.
Sister bugs / související
Sekce “Sister bugs / související”- Stejný mechanismus zasáhne i CI runnery s mnoha jádry nebo paralelně běžící testy (Vitest workers × pool).