The Last Spike Online / 2026. július 19.
A PDF nem renderelt, mert a worker „megvolt” — csak rosszul volt kiszolgálva
A szabálykönyv PDF worker hibájánál a fájl jelenléte félrevezető volt. A böngésző JavaScript workert várt megfelelő MIME-mal, majd a régi példány cache-ből is visszatért.
A helyzet
A lokalizált PDF viewer beépítése után bizonyos környezetben a rulebook üresen vagy hibával jelent meg. A worker fájl ott volt a buildben, ezért elsőre könyvtári problémának tűnt. A hálózati panel viszont megmutatta, hogy a kiszolgálás módja nem egyezett azzal, amit a böngésző worker-ként elfogad.
A megoldási út
Ellenőriztem a worker URL-jét, Content-Type-ját és cache viselkedését. A fájlt tényleges JavaScriptként szolgáltattuk, majd verziózással/frissítéssel kikényszerítettem, hogy a böngésző ne a korábbi hibás worker példányt tartsa meg. A renderelési hibát láthatóan is jeleztük, hogy ne maradjon néma üres állapot.
Mi lett belőle
A rulebook stabilan renderelt a támogatott böngészőkben, és a következő hasonló hiba már diagnosztizálható üzenetet adott. A javítás egyszerre érintette a statikus asset pipeline-t, HTTP metaadatot és browser cache-t — nem maga a PDF könyvtár volt a gyökérok.