...
Eroare System Design · Erori HTTP la proxy și load balancer: 502, 503, 504

Error: socket hang up (ECONNRESET)

Pe scurt

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

Greșit
const agent = new http.Agent({ keepAlive: true });
// fără limită de inactivitate pe client
// ALB: idle timeout 60s
Corect
const 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

Greșit
retry(() => axios.post('/plati', plata), 3);
Corect
axios.post('/plati', plata, {
  headers: { 'Idempotency-Key': plata.id },
});  // serverul ignoră duplicatele cu aceeași cheie

Un reset nu spune dacă cererea a fost procesată. Doar cu cheie de idempotență reîncercarea e sigură.

Repară tu

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.

Alte forme ale mesajului

  • java.net.SocketException: Connection reset
  • read: connection reset by peer
  • ConnectionResetError: [Errno 104] Connection reset by peer
  • Error: 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

← 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.