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

could not extend file "base/16384/24576": No space left on device (fișiere salvate pe disc / în bază)

Pe scurt

Discul bazei de date (sau al serverului) s-a umplut, de obicei pentru că fișierele încărcate de utilizatori (poze, PDF-uri) sunt salvate în bază sau pe discul local. Mută fișierele într-un object storage și păstrează în bază doar metadatele (cheia fișierului, mărimea, proprietarul).

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

Ce înseamnă

PostgreSQL afișează could not extend file ...: No space left on device când nu mai poate mări un fișier de date; alte componente scriu ENOSPC sau No space left on device. Odată ajuns aici, baza refuză scrierile și uneori nu mai pornește până eliberezi spațiu.

Într-o aplicație obișnuită, datele structurate (comenzi, utilizatori) cresc încet. Fișierele cresc repede: o poză are megaocteți, cât milioane de rânduri. Salvate ca bytea/BLOB în bază, ele umflă backup-urile, replicarea și discul. Salvate pe discul serverului de aplicație, sunt pierdute la înlocuirea serverului și invizibile pentru celelalte instanțe.

Object storage (S3, GCS, Azure Blob) e făcut pentru fișiere: capacitate practic nelimitată, redundanță internă, cost mic pe GB și integrare directă cu CDN-ul. Baza păstrează doar referința (cheie = poze/42/profil.jpg).

De ce apare: cauzele frecvente

1Fișier salvat în bază

Greșit
INSERT INTO poze (produs_id, continut) VALUES (42, :bytes);   -- 5 MB per rând
Corect
s3.put_object(Bucket='magazin-poze', Key='produse/42/1.jpg', Body=fisier)
INSERT INTO poze (produs_id, cheie, marime) VALUES (42, 'produse/42/1.jpg', 5242880);

Baza ține doar câțiva octeți de referință; fișierul stă în object storage.

2Fișier salvat pe discul serverului

Greșit
fisier.save(os.path.join('/var/uploads', nume))
Corect
s3.upload_fileobj(fisier, 'magazin-uploads', f'uploads/{uuid4()}/{nume}')

Pe discul local, fișierul există doar pe o instanță și dispare la înlocuirea ei.

Repară tu

Repară eroarea, direct în pagină

Pozele încărcate de utilizatori (10 pe secundă, câte 20 MB) rămân pe discul serverului, iar discul bazei s-a umplut. Adaugă un loc potrivit pentru fișiere și leagă-l de server, ca fișierele să nu mai fie pe discul serverelor.

Indiciu

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

Alte forme ale mesajului

  • ERROR: could not extend file "base/16384/24576": No space left on device
  • OSError: [Errno 28] No space left on device
  • ENOSPC: no space left on device, write

Cum o eviți pe viitor

  • Pune fișierele utilizatorilor în object storage, de la început.
  • Păstrează în bază doar metadatele fișierelor.
  • Alertează când discul bazei trece de 70–80%.
  • Activează creșterea automată a stocării la bazele gestionate, ca plasă de siguranță.

Întrebări frecvente

Ce fac dacă baza e deja plină?

Eliberează spațiu rapid (loguri vechi, WAL arhivat, tabele temporare) sau mărește discul, apoi migrează fișierele în object storage și șterge coloanele mari. VACUUM FULL recuperează spațiul, dar blochează tabelul.

E vreodată bine să ții fișiere în bază?

Pentru fișiere foarte mici și puține, care trebuie să fie în aceeași tranzacție cu datele, e acceptabil. Pentru poze și documente încărcate de utilizatori, nu.

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.