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

upstream prematurely closed connection while reading response header from upstream

Pe scurt

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.

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

Ce înseamnă

Spre deosebire de Connection refused (nu ascultă nimeni) sau de timed out (nu răspunde nimic), aici conexiunea a mers: nginx a trimis cererea, iar serverul a închis-o brusc, fără antetele răspunsului. „Prematurely” înseamnă că s-a închis mai devreme decât se aștepta protocolul HTTP.

Trei cauze acoperă aproape toate cazurile. Prima: procesul aplicației moare în timpul cererii, din cauza unei excepții care oprește tot procesul sau a kernelului care îl omoară pentru memorie (în dmesg apare Out of memory: Killed process). A doua: serverul de aplicație are un timeout de keep-alive mai mic decât proxy-ul, deci închide o conexiune inactivă exact când nginx o refolosește. A treia: un timeout intern al serverului de aplicație (de exemplu Gunicorn --timeout) omoară workerul care lucrează prea mult.

Dacă eroarea vine mereu de la același URL, e o cerere care consumă prea mult; dacă apare aleator, la trafic mic, e aproape sigur keep-alive-ul.

De ce apare: cauzele frecvente

1Workerul Gunicorn e omorât de propriul timeout

Greșit
gunicorn app:app --workers 4 --timeout 30
# raportul durează 45 de secunde
Corect
gunicorn app:app --workers 4 --timeout 30
# raportul se generează într-un job asincron,
# cererea doar îl pornește

Când trece --timeout, Gunicorn omoară workerul, iar conexiunea cu nginx se închide fără răspuns. Operațiile lungi nu se fac în cererea HTTP.

2Keep-alive mai scurt pe server decât pe proxy

Greșit
# Node.js: server.keepAliveTimeout = 5000 (implicit)
# load balancer: idle timeout 60s
Corect
server.keepAliveTimeout = 65000;
server.headersTimeout = 66000;

Serverul închide conexiunea inactivă după 5 secunde, dar load balancer-ul o consideră validă 60 de secunde și trimite pe ea o cerere nouă. Timeout-ul serverului trebuie să fie mai mare decât al proxy-ului.

3Fișierul încărcat e citit întreg în memorie

Greșit
byte[] date = request.getInputStream().readAllBytes();
Corect
try (InputStream in = request.getInputStream()) {
    storage.upload(cheie, in);   // streaming, bucată cu bucată
}

Un fișier de câțiva GB citit în memorie depășește limita containerului și procesul e omorât.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre mesajul upstream prematurely closed connection: ce s-a întâmplat, care sunt cauzele și ce verifici la upload-uri mari.

Indiciu

Gândește-te în ce moment s-a închis conexiunea: înainte de conectare, în timpul așteptării sau după ce cererea a plecat.

Alte forme ale mesajului

  • upstream prematurely closed connection while reading upstream
  • upstream sent no valid HTTP/1.0 header while reading response header from upstream
  • recv() failed (104: Connection reset by peer) while reading response header from upstream

Cum o eviți pe viitor

  • Aliniază timeout-urile: keep-alive-ul serverului mai mare decât idle timeout-ul proxy-ului.
  • Nu ține fișiere mari în memorie; folosește streaming sau upload direct în object storage.
  • Monitorizează repornirile proceselor și evenimentele OOM.
  • Mută operațiile lungi în joburi asincrone.

Întrebări frecvente

De ce apare eroarea doar la trafic mic, noaptea?

La trafic mic conexiunile keep-alive stau inactive mai mult, iar serverul le închide. Cu trafic mare sunt refolosite des și nu ajung la timeout. E semnul clasic al nepotrivirii de keep-alive.

Unde văd dacă procesul a fost omorât pentru memorie?

În dmesg sau journalctl -k (linia Out of memory: Killed process), iar în Docker în docker inspect, câmpul OOMKilled. În Kubernetes, starea podului arată OOMKilled.

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.