Přeskočit na obsah

Statický web převezme apex doménu a tiše rozbije interní absolutní URL aplikace (PDF rendering, assety)

  • 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.

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-assets

Př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.

  1. Doplnit chybějící cesty do proxy bloku statického webu (pdf-assets, uploads, …) a znovu vygenerovat postižené dokumenty.
  2. 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í.
  3. Do smoke testu po podobné změně zařadit i regeneraci jednoho PDF a kontrolu počtu vložených obrázků (pdfimages -list).
  • 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.
Přidal aiarchitekt.cz · 3. 9. 2026 2:00
Provozuje aiarchitekt.cz