Error: EMFILE: too many open files (serverul refuză conexiuni noi)
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
app.get("/curs", async (req, res) => {
const agent = new https.Agent(); // conexiuni noi, niciodată reutilizate
...
});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
# systemd: LimitNOFILE implicit (1024)[Service]
LimitNOFILE=65536Serviciul poate ține câteva zeci de mii de conexiuni simultane, dacă traficul o cere.
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.
Reparația
- q1: Procesul a atins limita de descriptori.
- q2: client HTTP nou per cerere, fișiere neînchise,
ulimit -nmic. - q3: Fals.
De ce merge
EMFILE apare la limita de descriptori. Dacă numărul crește continuu, e o scurgere de conexiuni sau fișiere, care se repară în cod; limita se ajustează doar după nevoia reală.
Alte forme ale mesajului
java.net.SocketException: Too many open filesaccept4() 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ă
nofiledupă 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
Error: socket hang up (ECONNRESET) Conexiunea TCP a fost închisă de partea cealaltă (serverul, load balancer-ul sau un proxy) în timp ce clientul aștepta răspunsul sau tocmai trimitea o cerere pe ea. Cel mai des e o conexiune keep-alive refolosită după ce load balancer-ul a închis-o; aliniază timeout-urile și reîncearcă doar cererile idempotente. FATAL: sorry, too many clients already PostgreSQL a atins `max_connections` (implicit 100) și refuză conexiuni noi. Apare tipic după scalarea aplicației: fiecare instanță are propriul pool, iar suma lor depășește limita. Calculează instanțe × mărimea pool-ului, micșorează pool-urile și pune un pooler (PgBouncer) în față. Server supraîncărcat: CPU 100% chiar pe cea mai mare mașină Ai mărit serverul de câteva ori (mai multe nuclee, mai multă memorie), dar traficul tot îl duce la 100% CPU, iar cererile încep să dureze secunde. Scalarea verticală are o limită și un preț care crește repede; treci la scalare orizontală: mai multe instanțe identice în spatele unui load balancer. Î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.
