Next build (Turbopack) po deployi servíruje nové HTML se starým CSS
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nasazení kompletního redesignu (tmavé téma, nové Tailwind tokeny) proběhlo bez chyby: lint, build, migrace, PM2 restart, smoke 200 na všech URL. curl vrací nové HTML s novými třídami (bg-ink-950). V prohlížeči je ale web světlý: getComputedStyle(body).backgroundColor vrací barvu starého tématu, axe hlásí kontrast 1,4:1, getByText testy procházejí (text je v HTML), vizuální testy padají. Odkaz na CSS chunk v HTML existuje a vrací 200 – jen obsahuje starý stylesheet (body{background-color:var(--color-slate-50)}), nové tokeny v něm nejsou.
Root cause
Sekce “Root cause”Deploy kopíruje rsyncem zdrojáky (--exclude .next) a na serveru spouští next build. Turbopack má persistentní build cache v .next/cache/turbopack (stovky MB), která mezi deployi přežívá. Globální stylesheet importovaný v layoutu (globals.css s @theme tokeny) se z cache vzal ve staré verzi, přestože soubor na disku byl nový – HTML/JS části se přebudovaly, CSS chunk ne. Výsledek: konzistentní build (žádná chyba), ale CSS neodpovídá zdroji. Stejná rodina chyb jako dev smyčka z .next/dev/cache (viz níže).
Ověření na serveru:
grep -c 'novy-token' src/app/globals.css # 3 → zdroj je novýgrep -c 'novy-token' .next/static/chunks/*.css # 0 → build je starýdu -sh .next/cache/turbopack # 231MFix
Sekce “Fix”# jednorázově na serverurm -rf .next/cache/turbopack && npx next build && pm2 restart app# trvale v deploy skriptu (lokální gate i server)... && npx prisma migrate deploy && rm -rf .next/cache/turbopack && npx next build && ...Po rebuildu obsahuje CSS chunk nové tokeny a computed background odpovídá tématu. Cena: delší build (studená cache), což je u deploye přijatelné.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: po deployi porovnat
grepnového tokenu ve zdroji a ve vybudovaném CSS; E2E s axe (kontrast) nebo assert nagetComputedStyle(body).backgroundColor; smoke test jen na HTTP status to NEODHALÍ. - Anti-pattern: persistentní build cache sdílená mezi nasazeními bez invalidace; „build prošel = build je správný“.
- Lepší přístup: deterministický build – cache mazat před buildem, nebo build v čistém adresáři/CI a na server kopírovat hotový výstup.
Sister bugs / související
Sekce “Sister bugs / související”- Next dev (Turbopack) reloaduje v nekonečné smyčce – tatáž příčina (persistentní Turbopack cache) v dev režimu.