Přeskočit na obsah

Next dev (Turbopack): nová dynamická route vrací 500 „ENOENT build-manifest.json“ – klientská komponenta importuje serverový modul

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

Nová dynamická route (app/<sekce>/[id]/page.tsx) v next dev vrací 500. V logu i v overlay prohlížeče: ENOENT: no such file or directory, open '<projekt>/.next/dev/server/app/<sekce>/[id]/page/build-manifest.json'. Sousední routy ve stejné složce (/novy, seznam) fungují. Restart dev serveru ani smazání .next/cache nepomůže; plný výmaz .next/dev/cache (studený start) také ne. Anonymní curl na route vrátí 307 (redirect na přihlášení), takže probe bez přihlášení chybu neodhalí.

Stránka renderuje klientskou komponentu, která si pro popisky importovala z doménového modulu:

// dog-card.tsx ("use client")
import { BREEDING_STATUS_LABELS } from "@/lib/club/dogs";
// …/lib/club/dogs.ts importuje @/lib/audit (Prisma), ./dog-files (sharp), zámky nad DB…

Turbopack při sestavení klientského grafu narazí na serverové závislosti (Prisma client, sharp, node:fs), klientský chunk route nevznikne a server pak čte neexistující build-manifest.json. Chyba se neprojeví jako srozumitelný „module not found“, jen jako ENOENT manifestu – a tsc ani lint nic nehlásí, protože typově je vše v pořádku.

Popisky přesunout do modulu bez serverových závislostí a klientskou komponentu přepojit; doménový modul je může re-exportovat pro serverové použití:

lib/club/dogs.ts
// lib/club/dog-labels.ts – žádné importy
export const BREEDING_STATUS_LABELS: Record<string, string> = { nechovny: "nechovný", /* … */ };
export { BREEDING_STATUS_LABELS } from "./dog-labels";
// dog-card.tsx ("use client")
import { BREEDING_STATUS_LABELS } from "@/lib/club/dog-labels";

Po změně route naběhla bez restartu.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: při 500 s ENOENT …/page/build-manifest.json hledat v klientských komponentách dané route importy z modulů, které importují @prisma/client, sharp, node:* nebo @/lib/db. Pomůže grep -rn "from \"@/lib/" app/**/*.tsx nad soubory s "use client".
  • Anti-pattern: „jen si vezmu konstantu z domény“ – klientský import z tlustého serverového modulu.
  • Lepší přístup: *-labels.ts / *-constants.ts bez importů; serverové moduly je re-exportují. V code review u každé "use client" komponenty projít importy.

Sister bugs / související

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