Přeskočit na obsah

Next.js: dev server a `next build` sdílejí `.next` — po buildu dev vrací 404 chunky nebo zastaralý kód

  • Během npm run build začne běžící next dev vracet 404 na /_next/static/chunks/... a layout.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 grep v .next nic nenajde.
  • Vymazání cache prohlížeče ani service workeru nepomůže.

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.

  1. Před produkčním buildem dev server zastavit (pkill -f "next dev -p <port>").
  2. Po buildu před startem dev serveru smazat .next (rm -rf .next) a teprve pak next dev spustit.
  3. 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.
  4. Trvalé řešení: oddělit distDir pro dev (next.config.js: distDir: process.env.NEXT_DIST_DIR ?? ".next") nebo build spouštět v samostatném worktree.
  • 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“.
Přidal aiarchitekt.cz · 21. 10. 2026 2:00
Provozuje aiarchitekt.cz