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

X-Cache: Miss from cloudfront la aproape fiecare cerere (rata de hit a CDN-ului e mică)

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Antetul X-Cache: Miss from cloudfront (la alte CDN-uri cf-cache-status: MISS, X-Cache: MISS) spune că CDN-ul nu avea fișierul și l-a cerut originii. Câteva ratări sunt normale (prima cerere, fișiere noi). Dacă vezi Miss la aproape fiecare cerere, CDN-ul doar transmite traficul și originea suportă tot.

Cauze frecvente: originea trimite Cache-Control: no-store, private sau max-age=0 (des, implicit pentru răspunsurile dinamice ale framework-ului); URL-ul include un parametru care se schimbă (?v=1699999999, ?utm_source=...), iar CDN-ul îl folosește în cheie; răspunsul setează cookie-uri și CDN-ul nu-l păstrează; sau o politică de cache cu TTL de câteva secunde.

Verifică cu curl -I antetele de la origine și de la CDN, apoi politica de cache: ce parametri, antete și cookie-uri intră în cheie.

De ce apare: cauzele frecvente

1Originea interzice cache-ul

Greșit
HTTP/1.1 200 OK
Cache-Control: no-cache, no-store, must-revalidate
Corect
HTTP/1.1 200 OK
Cache-Control: public, max-age=31536000, immutable
# pentru fișiere cu nume versionat

CDN-ul respectă antetele originii; fără permisiune explicită, nu păstrează fișierul.

2Parametru variabil în URL

Greșit
<script src="/app.js?t=<%= Date.now() %>"></script>
Corect
<script src="/app.3f9a2c.js"></script>
# și CDN-ul ignoră parametrii de marketing în cheie

Fiecare valoare nouă a parametrului e o cheie nouă în CDN, deci o ratare garantată.

Repară tu

Repară eroarea, direct în pagină

CDN-ul are rata de hit de doar 30% (originea trimite no-store și URL-urile au un parametru ?t=), deci serverele primesc majoritatea fișierelor statice și sunt peste capacitate. După repararea antetelor și a cheilor, rata de hit ajunge la 92%. Setează rata de hit și verifică: toate cererile tratate, componentele sub 80%.

Indiciu

Rata de hit se setează din panoul CDN-ului.

Alte forme ale mesajului

  • cf-cache-status: MISS
  • X-Cache: MISS
  • X-Cache: Miss from cloudfront

Cum o eviți pe viitor

  • Trimite Cache-Control explicit pentru fiecare tip de fișier.
  • Folosește nume versionate în loc de parametri de tip timestamp.
  • Configurează cheia de cache a CDN-ului: doar parametrii care schimbă conținutul.
  • Urmărește rata de hit și traficul spre origine.

Întrebări frecvente

Ce înseamnă X-Cache: RefreshHit?

CDN-ul avea fișierul, dar expirase; a verificat la origine (cerere condiționată) și a aflat că nu s-a schimbat. E mult mai ieftin decât o ratare completă.

Cum testez dacă un fișier e păstrat în CDN?

Cere-l de două ori cu curl -I: a doua oară trebuie să vezi Hit și antetul Age crescând.

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.