Statický web převezme apex doménu a tiše rozbije interní absolutní URL aplikace (PDF rendering, assety)
Příznaky
Sekce “Příznaky”- Vygenerované PDF (nabídky, faktury) jsou najednou „jen text” — bez loga, pozadí a fotek; velikost souboru spadne řádově (MB → desítky kB).
- Chyba se projeví až při další regeneraci dokumentu — starší cache vypadá OK, takže incident vypadá jako náhodný.
- V logu nemusí být žádná chyba: headless prohlížeč jen dostane 404 na obrázky a stránku vyrenderuje bez nich.
Příčina
Sekce “Příčina”Aplikace skládá absolutní URL k vlastním assetům z BASE_URL
(např. NEXTAUTH_URL), typicky pro server-side rendering PDF přes
headless Chromium:
const BG_BASE = appUrl() + "/pdf-assets"; // https://apex.tld/pdf-assetsPři nasazení nového statického webu na apex (server_name apex.tld s
root /var/www/web) se do aplikace proxuje jen ručně vyjmenovaný seznam
cest (/api, /_next, /blog, …). Cesty, které používá pouze
server-side kód (asset adresáře pro PDF, upload cesty), v seznamu
snadno chybí — nikdo je nevidí v prohlížeči, takže smoke test projde
a rozbití se objeví až u první regenerace dokumentu.
Řešení
Sekce “Řešení”- Doplnit chybějící cesty do proxy bloku statického webu
(
pdf-assets,uploads, …) a znovu vygenerovat postižené dokumenty. - Preventivně: před převzetím apexu vygrepovat aplikaci na skládání
absolutních URL z BASE_URL (
appUrl(,NEXTAUTH_URL,BASE_URL) a každou nalezenou cestu buď proxovat, nebo přepnout na interníhttp://localhost:<port>fetch, který nginx obchází. - Do smoke testu po podobné změně zařadit i regeneraci jednoho PDF
a kontrolu počtu vložených obrázků (
pdfimages -list).
Diagnostika
Sekce “Diagnostika”pdfimages -list dokument.pdf— zdravý dokument má velké obrázky, rozbitý jen ikony.- Porovnat čas první rozbité regenerace s časem nasazení webu.
curl -s -o /dev/null -w "%{http_code}" https://apex.tld/<asset-cesta>pro každou cestu, kterou server-side kód skládá z BASE_URL.