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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
socket hang up este mesajul Node.js (cod ECONNRESET) pentru o conexiune închisă brusc de cealaltă parte. În Java apare ca java.net.SocketException: Connection reset, în Go ca read: connection reset by peer, iar în Python ca ConnectionResetError: [Errno 104] Connection reset by peer.
Într-o arhitectură cu servicii care se apelează între ele, cauza tipică e o nepotrivire de timeout-uri. Clientul HTTP păstrează conexiunile deschise ca să le refolosească (keep-alive). Load balancer-ul sau serverul închide conexiunile inactive după un timp. Dacă clientul le ține mai mult decât le ține cealaltă parte, la un moment dat trimite o cerere pe o conexiune deja închisă și primește reset.
Alte cauze: serverul a căzut în timpul cererii, un proxy a omorât o conexiune lungă, sau serverul a închis conexiunea pentru că cererea a depășit o limită. Eroarea apare aleator și rar, de aceea e greu de reprodus: caută corelația cu perioadele de inactivitate dintre cereri.
De ce apare: cauzele frecvente
1Clientul păstrează conexiunile mai mult decât load balancer-ul
const agent = new http.Agent({ keepAlive: true });
// fără limită de inactivitate pe client
// ALB: idle timeout 60sconst agent = new http.Agent({
keepAlive: true,
timeout: 50000, // < 60s, idle timeout-ul ALB
});Clientul nu mai folosește conexiunile pe care load balancer-ul e pe cale să le închidă, deci nu mai trimite cereri pe conexiuni moarte.
2Reîncercare oarbă a unei scrieri
retry(() => axios.post('/plati', plata), 3);axios.post('/plati', plata, {
headers: { 'Idempotency-Key': plata.id },
}); // serverul ignoră duplicatele cu aceeași cheieUn reset nu spune dacă cererea a fost procesată. Doar cu cheie de idempotență reîncercarea e sigură.
Repară eroarea, direct în pagină
Răspunde la cele trei întrebări despre socket hang up între două servicii aflate în spatele unui load balancer.
Indiciu
Compară cât ține clientul o conexiune deschisă cu cât o ține load balancer-ul.
Reparația
- q1: Clientul refolosește o conexiune deja închisă de load balancer.
- q2: idle timeout mai mic pe client și reîncercarea cererilor idempotente cu backoff.
- q3: Fals: fără cheie de idempotență plata poate fi dublată.
De ce merge
Clientul refolosea conexiuni pe care load balancer-ul le închisese deja. Cu idle timeout-ul clientului sub cel al load balancer-ului, eroarea dispare aproape complet, iar reîncercările automate rămân doar pentru cereri idempotente sau protejate cu cheie.
Alte forme ale mesajului
java.net.SocketException: Connection resetread: connection reset by peerConnectionResetError: [Errno 104] Connection reset by peerError: read ECONNRESET
Cum o eviți pe viitor
- Fă idle timeout-ul clientului mai mic decât cel al serverului și al load balancer-ului.
- Reîncearcă automat doar cererile idempotente, cu backoff și limită de încercări.
- Folosește chei de idempotență pentru scrierile importante.
- Logează cererile resetate împreună cu cât timp a stat conexiunea inactivă.
Întrebări frecvente
De ce apare doar din când în când?
Pentru că e nevoie de o coincidență: o conexiune a stat inactivă exact cât să fie închisă de load balancer, iar clientul a ales-o tocmai pe ea. La trafic constant, conexiunile nu ajung la idle timeout.
E o problemă a serverului apelat?
Rar. De cele mai multe ori serverul e sănătos, iar reset-ul vine de la o componentă intermediară care închide conexiunile inactive. Verifică întâi timeout-urile de pe drum.
Erori înrudite
upstream prematurely closed connection while reading response header from upstream Serverul din spatele nginx a închis conexiunea înainte să trimită răspunsul, deci clientul primește 502. Cel mai des procesul a căzut (excepție netratată, OOM kill) sau a închis o conexiune keep-alive pe care nginx tocmai o refolosea. Caută în logurile aplicației și în `dmesg` exact la momentul erorii. Același mesaj procesat de două ori (clientul primește două SMS-uri / e taxat de două ori) Cozile garantează de obicei livrarea „cel puțin o dată” (at-least-once): după un timeout, o eroare sau o reîncercare, același mesaj poate ajunge de două ori la consumator. Fă procesarea idempotentă: salvează id-ul mesajului procesat și ignoră duplicatele, sau folosește chei de idempotență la apelurile externe. Retry storm: reîncercările fără backoff înmulțesc traficul și țin serviciul căzut La primele erori, toți clienții reîncearcă imediat, de mai multe ori, iar serviciul deja suprasolicitat primește de câteva ori mai mult trafic și nu-și mai poate reveni. Reîncearcă doar erorile temporare, cu backoff exponențial și jitter, cu un număr mic de încercări și un buget de reîncercări. Î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.
