Přeskočit na obsah

next build na stroji s mnoha jádry vyčerpá PostgreSQL – workery × výchozí pool Prismy > max_connections

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

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 already
Error occurred prerendering page "/de"
⨯ Next.js build worker exited with code: 1

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

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.

Velikost poolu se odvozuje od fáze, explicitní hodnota v URL vyhrává:

src/lib/db-url.ts
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.ts
new 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_connections vs. nproc; v logu buildu počet workerů („using N workers“).
  • Anti-pattern: DATABASE_URL bez parametrů poolu + prerender, který při buildu čte z databáze; diagnostika podle prvního varování ve výstupu místo prvního Error.
  • Lepší přístup: pool podle fáze (build malý, runtime podle počtu procesů), případně experimental.cpus v next.config pro 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).
Přidal aiarchitekt.cz · 12. 11. 2026 1:00
Provozuje aiarchitekt.cz