Next dev (Turbopack): nová dynamická route vrací 500 „ENOENT build-manifest.json“ – klientská komponenta importuje serverový modul
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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í.
Root cause
Sekce “Root cause”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.
Fix
Sekce “Fix”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/dog-labels.ts – žádné importyexport 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.jsonhledat v klientských komponentách dané route importy z modulů, které importují@prisma/client,sharp,node:*nebo@/lib/db. Pomůžegrep -rn "from \"@/lib/" app/**/*.tsxnad 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.tsbez 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í”- Next dev (Turbopack) po restartu reloaduje stránku v nekonečné smyčce – jiný projev stavu
.next/dev; zde ale cache nebyla příčinou. - Turbopack po přidání exportu do existujícího lib modulu drží starý chunk („Neznámá šablona“) – řeší restart dev serveru; tento bug restart neřeší.