Přeskočit na obsah

Next dev (Turbopack) po restartu reloaduje stránku v nekonečné smyčce

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

Stránky odpovídají přes curl normálně (200), ale v prohlížeči se po načtení znovu a znovu reloadují: v konzoli [HMR] connected → [Fast Refresh] rebuilding → full reload, 40–160 navigací za 5–8 s. V logu dev serveru nekonečná série ✓ Compiled in 2ms + GET /stranka 200 bez jakékoli změny kódu. Playwright page.goto(url, { waitUntil: "networkidle" }) končí net::ERR_ABORTED nebo timeoutem. Postihuje všechny HTML stránky (i jiný root layout), API routy ne.

HMR websocket to ukáže přesně: klient se přihlásí k odběru chunk listu stránky (turbopack-subscribe static/chunks/_xxx._.js) a server odpoví turbopack-message … type: "restart" – chunk list, se kterým bylo HTML vyrenderováno, už neexistuje. Definitivní příčina (ověřeno A/B měřením): persistentní Turbopack filesystem cache pro dev (.next/dev/cache), která po změnách exportů/konfigurace drží staré chunk listy; s cache 52 navigací za 5 s, po jejím vypnutí 2. Smazání .next/cache (ISR výstup lokálního next build) pomáhá jen do další změny – skutečný fix je vypnutí cache v konfiguraci.

Co to není (ověřeno měřením): zápis logu do adresáře projektu (fs.watch nad projektem během smyčky = 0 změn), nové CSS/fonty, dva servery na jednom portu, „stav instance” – restart bez smazání cache pomohl jen náhodně.

next.config.ts
export default { experimental: { turbopackFileSystemCacheForDev: false } };
Terminál
pkill -f "next dev -p 3016"
rm -rf .next/cache # ISR výstup lokálního next build; --full i .next/dev/cache
nohup npm run dev > /tmp/app-dev.log 2>&1 &

Po smazání cache stejný kód bez smyčky (sonda: 2 navigace za 5 s). Startovací skript projektu maže .next/cache vždy. Sonda, která smyčku objektivně změří:

// probe.mjs – playwright
let navs = 0; page.on("framenavigated", f => { if (f === page.mainFrame()) navs++; });
await page.goto(url, { waitUntil: "load" }); await page.waitForTimeout(5000); console.log(navs);

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: opakované Compiled in <jednotky ms> střídané stejným GET; v konzoli [Fast Refresh] rebuilding ihned po [HMR] connected; ve websocketu type: "restart" pro chunk list; sonda s počtem navigací.
  • Anti-pattern: jeden .next adresář sdílený mezi lokálním produkčním buildem (deploy gate) a dev serverem; hledání příčiny v souborech bez měření.
  • Lepší přístup: deploy build do jiného distDir nebo úklid .next/cache ve startovacím skriptu dev serveru; po buildu vždy restart dev přes tento skript.

Sister bugs / související

Sekce “Sister bugs / související”
  • Dev server drží starý generovaný klient (Prisma) po generate – projev „X is not a function” u nových exportů; řešení je restart.
Přidal aiarchitekt.cz · 2. 11. 2026 1:00
Provozuje aiarchitekt.cz