CDN-ul servește fișierele vechi după deploy (CSS/JS vechi, pagina stricată)
După deploy, CDN-ul (și browserele) au încă în cache versiunea veche a fișierelor cu același nume, iar HTML-ul nou se combină cu JavaScript sau CSS vechi. Folosește nume de fișiere cu hash (cache busting) și TTL lung pentru ele, iar HTML-ul cu revalidare; purge-ul e doar o soluție de urgență.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Dacă fișierul se numește tot app.js și are max-age de o zi, CDN-ul și browserele au tot dreptul să-l servească o zi întreagă, chiar dacă pe server e deja versiunea nouă. Rezultatul e o combinație de versiuni: HTML nou cu JavaScript vechi (erori în consolă, butoane care nu merg) sau CSS vechi (pagină aranjată greșit), diferit de la utilizator la utilizator, în funcție de nodul CDN și de cache-ul browserului.
Invalidarea manuală (purge / create-invalidation) curăță nodurile CDN, dar nu ajunge în browsere, durează câteva minute și e ușor de uitat.
Soluția standard e cache busting: bundler-ul (Vite, webpack) pune hash-ul conținutului în nume (app.3f9a2c.js). Fiecare versiune are alt URL, deci poate fi păstrată un an (immutable), iar HTML-ul, care se schimbă la fiecare deploy, e servit cu revalidare (no-cache sau TTL scurt) și referă mereu numele noi.
De ce apare: cauzele frecvente
1Același nume pentru fiecare versiune
<link rel="stylesheet" href="/css/stil.css">
# Cache-Control: max-age=86400<link rel="stylesheet" href="/assets/stil.8c1d4e.css">
# assets: max-age=31536000, immutable
# index.html: no-cacheNumele nou forțează descărcarea versiunii noi, iar HTML-ul revalidat referă mereu numele corecte.
2Invalidare uitată sau parțială
aws s3 sync dist/ s3://site/ # fără invalidareaws s3 sync dist/ s3://site/
aws cloudfront create-invalidation --distribution-id E123 --paths "/index.html"Cu fișierele versionate, trebuie invalidat doar HTML-ul (sau deloc, dacă are TTL scurt).
Repară eroarea, direct în pagină
Răspunde la cele trei întrebări despre fișierele vechi servite de CDN după deploy.
Indiciu
Ce se întâmplă dacă fiecare versiune a fișierului are alt nume?
Reparația
- q1: Nume de fișiere cu hash-ul conținutului, cu TTL lung.
- q2:
no-cachesaumax-agescurt. - q3: Fals.
De ce merge
Cu nume versionate, CDN-ul și browserul nu mai pot confunda versiunile. HTML-ul revalidat aduce numele noi, iar purge-ul nu ajunge în browsere, deci nu e o soluție completă.
Alte forme ale mesajului
Uncaught TypeError: ... is not a function (după deploy, JS vechi din cache)ChunkLoadError: Loading chunk 42 failed.
Cum o eviți pe viitor
- Pune hash-ul conținutului în numele fișierelor statice.
- TTL lung (
immutable) pentru fișierele versionate, revalidare pentru HTML. - Păstrează câteva versiuni vechi pe origine, pentru paginile deja deschise.
- Folosește purge doar pentru urgențe sau pentru fișiere fără versiune.
Întrebări frecvente
Ce e ChunkLoadError după deploy?
Pagina deschisă înainte de deploy cere un fișier (chunk) din versiunea veche, care a fost șters de pe origine. Păstrează fișierele vechi o perioadă sau reîncarcă pagina la această eroare.
Purge-ul e gratuit?
Depinde de CDN: unele includ un număr de invalidări gratuite pe lună, apoi taxează pe cale. Oricum, nu rezolvă cache-ul browserelor.
Erori înrudite
Date vechi în cache după actualizare (prețul vechi apare încă pe site) Ai modificat datele în bază, dar cache-ul încă ține valoarea veche și o servește până expiră. La orice scriere, invalidează (șterge) cheia din cache imediat după scrierea în bază și păstrează un TTL rezonabil ca plasă de siguranță. X-Cache: Miss from cloudfront la aproape fiecare cerere (rata de hit a CDN-ului e mică) CDN-ul există, dar aproape fiecare cerere e o ratare și merge la origine: antetele `Cache-Control` lipsesc sau interzic cache-ul, URL-urile au parametri care se schimbă (timestamp, utm), sau TTL-ul e foarte scurt. Corectează antetele și cheile de cache, iar originea primește doar ratările reale. Access to font at 'https://cdn.magazin.ro/...' from origin 'https://magazin.ro' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. Browserul a blocat fontul (sau fișierul cerut cu `fetch`) de pe domeniul CDN-ului pentru că răspunsul nu are antetul `Access-Control-Allow-Origin` pentru site-ul tău. Configurează CORS la origine (bucket / server), fă CDN-ul să transmită antetul `Origin` și să-l includă în cheia de cache, apoi invalidează răspunsurile vechi. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
