Přeskočit na obsah

Next build (Turbopack) po deployi servíruje nové HTML se starým CSS

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

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.

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:

Terminál
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 # 231M
Terminál
# jednorázově na serveru
rm -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 grep nového tokenu ve zdroji a ve vybudovaném CSS; E2E s axe (kontrast) nebo assert na getComputedStyle(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í”
Přidal aiarchitekt.cz · 3. 11. 2026 1:00
Provozuje aiarchitekt.cz