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

Pozele încărcate dau 404 pe alt server sau dispar după deploy (salvate pe discul local)

Pe scurt

Fișierele încărcate de utilizatori sunt salvate pe discul serverului care a primit upload-ul: celelalte servere nu le au (404 la jumătate din cereri), iar la redeploy sau la înlocuirea serverului se pierd. Salvează-le într-un object storage comun (S3, GCS, Azure Blob) și servește-le prin CDN.

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

Ce înseamnă

Cu un singur server, salvarea în /uploads merge perfect. Când apare al doilea server în spatele load balancer-ului, poza încărcată pe serverul A nu există pe serverul B: utilizatorul își vede avatarul la o reîncărcare și primește 404 la următoarea. În containere sau cu autoscalare, discul local e temporar: la fiecare deploy sau la oprirea unei instanțe, fișierele dispar complet.

Soluțiile „rapide” (un disc partajat NFS, sincronizare cu rsync între servere, sticky sessions) aduc probleme noi: NFS devine SPOF și gât de sticlă, sincronizarea întârzie, iar sticky sessions nu ajută la deploy.

Varianta standard: fișierele în object storage (durabil, redundant, practic nelimitat), în bază doar cheia fișierului și metadatele, iar livrarea prin CDN. Pentru fișiere mari, clientul încarcă direct în object storage cu URL presemnat.

De ce apare: cauzele frecvente

1Salvare pe discul local

Greșit
@PostMapping("/avatar")
void avatar(@RequestParam MultipartFile f) throws IOException {
    f.transferTo(Path.of("/var/app/uploads", f.getOriginalFilename()));
}
Corect
@PostMapping("/avatar")
void avatar(@RequestParam MultipartFile f) throws IOException {
    String cheie = "avatare/" + UUID.randomUUID();
    s3.putObject(b -> b.bucket("magazin-media").key(cheie), RequestBody.fromInputStream(f.getInputStream(), f.getSize()));
    utilizatori.seteazaAvatar(idCurent(), cheie);
}

Toate serverele (și CDN-ul) citesc fișierul din același loc, iar deploy-urile nu-l afectează.

2Volum local în container

Greșit
docker run -v /tmp/uploads:/app/uploads magazin
Corect
# fișierele în object storage; containerul rămâne fără stare

Containerele pot fi înlocuite oricând fără pierderi.

Repară tu

Repară eroarea, direct în pagină

Serverele salvează pozele încărcate pe discul local, așa că pe celelalte servere dau 404, iar la deploy se pierd. Salvează fișierele într-un loc comun și durabil, cu toate cererile tratate.

Indiciu

Avertismentul din tab-ul Simulare spune unde ar trebui să stea fișierele.

Alte forme ale mesajului

  • 404 Not Found la /uploads/avatar.jpg (doar uneori)
  • ENOENT: no such file or directory, open '/app/uploads/...'
  • java.nio.file.NoSuchFileException

Cum o eviți pe viitor

  • Păstrează serverele fără stare: fișierele în object storage, sesiunile într-un store comun.
  • Salvează în bază doar cheia fișierului.
  • Servește fișierele prin CDN.
  • Testează cu cel puțin două instanțe și după un redeploy.

Întrebări frecvente

Un disc NFS comun nu e mai simplu?

Pare, dar devine un punct unic de eșec, are latență mare și nu scalează ca un object storage. E o soluție de tranziție, nu una finală.

Cum servesc fișierele private?

Bucket-ul rămâne privat, iar aplicația generează URL-uri presemnate cu expirare scurtă pentru utilizatorii care au dreptul să le vadă.

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.