Next dev (Turbopack) po restartu reloaduje stránku v nekonečné smyčce
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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.
Root cause
Sekce “Root cause”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ě.
Fix
Sekce “Fix”export default { experimental: { turbopackFileSystemCacheForDev: false } };pkill -f "next dev -p 3016"rm -rf .next/cache # ISR výstup lokálního next build; --full i .next/dev/cachenohup 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 – playwrightlet 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ýmGET; v konzoli[Fast Refresh] rebuildingihned po[HMR] connected; ve websocketutype: "restart"pro chunk list; sonda s počtem navigací. - Anti-pattern: jeden
.nextadresář 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
distDirnebo úklid.next/cacheve 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.