Next.js: dev server a `next build` sdílejí `.next` — po buildu dev vrací 404 chunky nebo zastaralý kód
Příznaky
Sekce “Příznaky”- Během
npm run buildzačne běžícínext devvracet404na/_next/static/chunks/...alayout.css; stránka je prázdná. - Po dokončení buildu a prostém restartu dev serveru stránka funguje, ale ukazuje starší verzi komponenty (např. select s jiným seznamem položek), i když zdroják je správně a
grepv.nextnic nenajde. - Vymazání cache prohlížeče ani service workeru nepomůže.
Příčina
Sekce “Příčina”next dev i next build zapisují do téhož adresáře .next. Build ho přepíše produkčním výstupem; dev server pak kombinuje svůj on-demand výstup s cizími artefakty. Výsledek je nedeterministický: chybějící chunky, nebo kompilace, která se tváří hotová, ale servíruje starší bundle.
Řešení
Sekce “Řešení”- Před produkčním buildem dev server zastavit (
pkill -f "next dev -p <port>"). - Po buildu před startem dev serveru smazat
.next(rm -rf .next) a teprve paknext devspustit. - Když E2E (Playwright) ukáže starý stav UI, nejdřív ověřit, které procesy sedí na portu (
lsof -nP -iTCP:<port> -sTCP:LISTEN) a čistotu.next, až potom hledat chybu v kódu. - Trvalé řešení: oddělit
distDirpro dev (next.config.js: distDir: process.env.NEXT_DIST_DIR ?? ".next") nebo build spouštět v samostatném worktree.
Prevence
Sekce “Prevence”- Deploy skript nikdy nespouštět proti adresáři, kde běží dev server; build v CI / na serveru.
- V checklistu před E2E: „dev server čistý
.next“.