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.
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
gunicorn app:app --workers 4 --timeout 30
# raportul durează 45 de secundegunicorn app:app --workers 4 --timeout 30
# raportul se generează într-un job asincron,
# cererea doar îl porneșteCâ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
# Node.js: server.keepAliveTimeout = 5000 (implicit)
# load balancer: idle timeout 60sserver.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
byte[] date = request.getInputStream().readAllBytes();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ă 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.
Reparația
- q1: Serverul a închis conexiunea înainte de răspuns.
- q2: OOM kill, excepția care oprește procesul, keep-alive-ul mai scurt pe server (nu portul greșit).
- q3: Adevărat.
De ce merge
Mesajul descrie o conexiune deschisă cu succes și închisă de server înainte de răspuns. De aceea cauzele sunt în procesul serverului (crash, OOM, timeout intern) sau în nepotrivirea de keep-alive, nu în configurarea adresei.
Alte forme ale mesajului
upstream prematurely closed connection while reading upstreamupstream sent no valid HTTP/1.0 header while reading response header from upstreamrecv() 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
502 Bad Gateway Proxy-ul sau load balancer-ul din fața aplicației a primit un răspuns invalid de la server, de obicei pentru că procesul aplicației a căzut, a repornit sau nu ascultă pe portul configurat. Verifici întâi logurile aplicației și ale proxy-ului, apoi health check-ul care trebuie să scoată instanțele moarte din rotație. 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. 413 Request Entity Too Large Cererea are un corp mai mare decât acceptă serverul sau proxy-ul din față (la nginx, implicit 1 MB prin `client_max_body_size`). Pentru fișiere mari, soluția bună nu e să mărești limita, ci să lași clientul să încarce direct în object storage, cu un URL presemnat. Î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.
