...
Eroare System Design · Servere supraîncărcate, scalare și sesiuni

Error: EMFILE: too many open files (serverul refuză conexiuni noi)

Pe scurt

Procesul a atins limita de descriptori de fișier, iar pe Linux fiecare socket (conexiune de la clienți, conexiune la bază sau la un API) consumă unul. Cauzele sunt fie o scurgere (conexiuni sau fișiere neînchise), fie o limită prea mică pentru numărul real de conexiuni. Repară scurgerea și reutilizează conexiunile, apoi ajustează `nofile` dacă e nevoie.

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

Ce înseamnă

Fiecare fișier deschis și fiecare socket TCP ocupă un descriptor. Limita implicită per proces e adesea 1024 (ulimit -n), prea mică pentru un server cu mii de clienți conectați. Când e atinsă, apelurile open(), accept() și connect() eșuează: Node.js aruncă EMFILE: too many open files, Java java.net.SocketException: Too many open files, iar nginx loghează accept4() failed (24: Too many open files).

Cauza poate fi legitimă (trafic mare, multe conexiuni keep-alive) sau o scurgere: un client HTTP creat la fiecare cerere, care deschide conexiuni noi și le lasă în TIME_WAIT sau CLOSE_WAIT; fișiere, stream-uri sau cursoare care nu sunt închise pe ramurile de eroare.

Diagnostic: ls /proc/<pid>/fd | wc -l sau lsof -p <pid> arată ce descriptori sunt deschiși și dacă numărul crește continuu (scurgere) sau doar urmează traficul.

De ce apare: cauzele frecvente

1Client HTTP nou la fiecare cerere

Greșit
app.get("/curs", async (req, res) => {
  const agent = new https.Agent();   // conexiuni noi, niciodată reutilizate
  ...
});
Corect
const agent = new https.Agent({ keepAlive: true, maxSockets: 50 });
app.get("/curs", async (req, res) => { /* folosește agent */ });

Un singur pool cu un număr limitat de conexiuni reutilizate.

2Limită mică pentru serviciu

Greșit
# systemd: LimitNOFILE implicit (1024)
Corect
[Service]
LimitNOFILE=65536

Serviciul poate ține câteva zeci de mii de conexiuni simultane, dacă traficul o cere.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre serverul care refuză conexiuni cu EMFILE.

Indiciu

Pe Linux, un socket e tot un fișier.

Alte forme ale mesajului

  • java.net.SocketException: Too many open files
  • accept4() failed (24: Too many open files)
  • OSError: [Errno 24] Too many open files

Cum o eviți pe viitor

  • Reutilizează conexiunile (pool-uri, keep-alive).
  • Închide fișierele și stream-urile și pe ramurile de eroare (try-with-resources, finally).
  • Urmărește numărul de descriptori deschiși ca metrică.
  • Setează nofile după numărul real de conexiuni.

Întrebări frecvente

Cum văd dacă e o scurgere?

Urmărește numărul de descriptori în timp: dacă crește continuu, chiar și când traficul scade, e o scurgere.

Ce înseamnă CLOSE_WAIT?

Celălalt capăt a închis conexiunea, dar aplicația ta nu și-a închis socket-ul. Multe CLOSE_WAIT înseamnă aproape mereu o scurgere în cod.

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.