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

connect() failed (111: Connection refused) while connecting to upstream

Pe scurt

nginx a încercat să deschidă o conexiune spre server și a primit refuz imediat: la adresa și portul din configurație nu ascultă niciun proces. Verifică dacă aplicația rulează, pe ce port ascultă și dacă `proxy_pass` / upstream-ul indică exact acea adresă.

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

Ce înseamnă

Codul 111 este ECONNREFUSED: mașina există și a răspuns, dar a spus „nu ascult pe portul ăsta”. E diferit de un timeout (mașina nu răspunde deloc) și de 502 cu prematurely closed (conexiunea s-a deschis, apoi s-a închis). Clientul primește 502 Bad Gateway.

Aproape întotdeauna e o problemă de configurare sau de pornire: aplicația nu a pornit (sau s-a oprit), ascultă pe alt port decât cel din nginx, ascultă doar pe 127.0.0.1 deși nginx e pe altă mașină, sau upstream-ul indică un server vechi, scos din funcțiune, după o migrare.

Linia de log arată upstream: "http://10.0.1.20:8080/": verifică direct de pe mașina nginx cu curl -v http://10.0.1.20:8080/health. Pe server, ss -ltnp arată ce procese ascultă și pe ce porturi.

De ce apare: cauzele frecvente

1Upstream-ul indică un server vechi

Greșit
upstream app {
    server 10.0.1.20:8080;   # serverul vechi, oprit după migrare
}
Corect
upstream app {
    server 10.0.2.11:8080;
    server 10.0.2.12:8080;
    server 10.0.2.13:8080;
}

După migrare, aplicația rulează pe alte mașini. Configurația proxy-ului trebuie actualizată, altfel fiecare cerere încearcă adresa veche.

2Aplicația ascultă doar pe localhost

Greșit
server:
  address: 127.0.0.1
  port: 8080
Corect
server:
  address: 0.0.0.0
  port: 8080

Pe 127.0.0.1 aplicația acceptă conexiuni doar de pe aceeași mașină. Un proxy aflat pe altă mașină primește refuz.

3Containerul nu publică portul

Greșit
docker run -d magazin-app
Corect
docker run -d -p 8080:8080 magazin-app

Fără -p, portul există doar în rețeaua containerului, iar pe mașină nu ascultă nimic pe 8080.

Repară tu

Repară eroarea, direct în pagină

După migrarea pe servere noi, load balancer-ul trimite tot traficul spre Server vechi (oprit), iar nginx scrie connect() failed (111: Connection refused). Serverele noi stau nefolosite. Fă ca cererile să ajungă la serverele noi și toate să fie tratate.

Indiciu

Uită-te unde duce săgeata load balancer-ului și ce componentă nu primește trafic deloc.

Alte forme ale mesajului

  • connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.5
  • connect() to 10.0.1.20:8080 failed (111: Connection refused)
  • dial tcp 10.0.1.20:8080: connect: connection refused

Cum o eviți pe viitor

  • Generează configurația proxy-ului din aceeași sursă ca lista de servere (service discovery, target groups), nu de mână.
  • Pune un health check: o țintă care refuză conexiuni iese din rotație.
  • După orice migrare, testează din mașina proxy-ului cu curl fiecare upstream.
  • Verifică la pornire că aplicația ascultă pe 0.0.0.0 și pe portul așteptat.

Întrebări frecvente

Aplicația rulează, curl localhost:8080 merge, dar nginx dă 111. De ce?

Probabil nginx e pe altă mașină sau în alt container, iar aplicația ascultă doar pe 127.0.0.1, ori un firewall respinge activ conexiunea. Testează cu curl exact de unde rulează nginx.

E la fel cu Connection timed out?

Nu. Refused înseamnă un răspuns imediat „nu e nimeni aici”. Timed out înseamnă că nu a răspuns nimic: mașina e oprită, adresa e greșită sau un firewall aruncă pachetele.

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.