...
Eroare System Design · CDN, fișiere statice și upload-uri

CDN-ul servește fișierele vechi după deploy (CSS/JS vechi, pagina stricată)

Pe scurt

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

Greșit
<link rel="stylesheet" href="/css/stil.css">
# Cache-Control: max-age=86400
Corect
<link rel="stylesheet" href="/assets/stil.8c1d4e.css">
# assets: max-age=31536000, immutable
# index.html: no-cache

Numele nou forțează descărcarea versiunii noi, iar HTML-ul revalidat referă mereu numele corecte.

2Invalidare uitată sau parțială

Greșit
aws s3 sync dist/ s3://site/   # fără invalidare
Corect
aws 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ă tu

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?

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

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

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