connect() failed (111: Connection refused) while connecting to upstream
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
upstream app {
server 10.0.1.20:8080; # serverul vechi, oprit după migrare
}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
server:
address: 127.0.0.1
port: 8080server:
address: 0.0.0.0
port: 8080Pe 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
docker run -d magazin-appdocker run -d -p 8080:8080 magazin-appFără -p, portul există doar în rețeaua containerului, iar pe mașină nu ascultă nimic pe 8080.
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.
Reparația
1. Conectează Load balancer → Server aplicație. 2. Atinge conexiunea Load balancer → Server vechi (oprit) și șterge-o.
Rezultat: cele 3 instanțe noi tratează tot traficul.
De ce merge
Load balancer-ul trimitea cererile la o țintă care nu mai răspunde. Conectat la serverul nou, cu trei instanțe, traficul e tratat; conexiunea spre serverul vechi se șterge, ca să nu mai primească cereri.
Alte forme ale mesajului
connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.5connect() 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
curlfiecare 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
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. no live upstreams while connecting to upstream nginx a marcat toate serverele din blocul `upstream` ca indisponibile și nu mai are unde trimite cererea, așa că răspunde 502. Apare tipic când există un singur server și acela a căzut sau a dat câteva erori la rând. Repari cu cel puțin două instanțe sănătoase și investighezi de ce au căzut. Health checks failed (Target.FailedHealthChecks) Load balancer-ul a marcat instanța ca nesănătoasă pentru că nu a răspuns corect la verificarea periodică (cod greșit, timeout, endpoint inexistent) și nu-i mai trimite trafic. Verifică endpoint-ul de health, timpul de pornire al aplicației și dacă health check-ul depinde inutil de baza de date. Î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.
