Pozele încărcate dau 404 pe alt server sau dispar după deploy (salvate pe discul local)
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
@PostMapping("/avatar")
void avatar(@RequestParam MultipartFile f) throws IOException {
f.transferTo(Path.of("/var/app/uploads", f.getOriginalFilename()));
}@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
docker run -v /tmp/uploads:/app/uploads magazin# fișierele în object storage; containerul rămâne fără stareContainerele pot fi înlocuite oricând fără pierderi.
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.
Reparația
1. Adaugă Object storage. 2. Conectează Server aplicație → Object storage.
Rezultat: fișierele sunt comune tuturor serverelor și supraviețuiesc deploy-urilor.
De ce merge
Pe discul local, fiecare fișier exista pe un singur server și dispărea la înlocuirea lui. În object storage, toate serverele îl găsesc, iar deploy-urile nu-l mai afectează.
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
Imaginile și fișierele CSS/JS se încarcă greu: sunt servite de serverul de aplicație, fără CDN Fiecare imagine, fișier CSS sau JS trece prin load balancer și prin serverul de aplicație, de la un singur centru de date, deci se încarcă lent pentru utilizatorii îndepărtați și ocupă serverele. Pune un CDN în fața lor: fișierele se servesc din noduri apropiate de utilizator, iar serverul vede doar ratările. 413 Request Entity Too Large Cererea are un corp mai mare decât acceptă serverul sau proxy-ul din față (la nginx, implicit 1 MB prin `client_max_body_size`). Pentru fișiere mari, soluția bună nu e să mărești limita, ci să lași clientul să încarce direct în object storage, cu un URL presemnat. Utilizatorii sunt delogați aleatoriu după ce ai adăugat al doilea server Sesiunile sunt ținute în memoria fiecărui server, iar load balancer-ul trimite cererile următoare la alt server, care nu cunoaște sesiunea, deci utilizatorul pare delogat sau coșul se golește. Mută sesiunile într-un loc comun (Redis) sau folosește tokenuri, ca serverele să fie stateless. Î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.
