Error: tunneling socket could not be established, cause=connect ECONNREFUSED 127.0.0.1:8888
Postman încearcă să treacă prin proxy-ul configurat (aici 127.0.0.1:8888), dar proxy-ul nu răspunde. Oprește proxy-ul din Settings → Proxy dacă nu ai nevoie de el, pornește-l (de exemplu Fiddler, Charles) sau corectează adresa proxy-ului firmei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Prin HTTPS, un proxy deschide un tunel (metoda CONNECT): clientul se conectează la proxy, îi cere să deschidă legătura spre server, apoi vorbește TLS prin ea. Mesajul spune că tunelul nu s-a putut crea, iar după cause= vine motivul: aici ECONNREFUSED 127.0.0.1:8888, adică proxy-ul de pe portul 8888 nu rulează.
Cazuri tipice:
- ai folosit odată un proxy de depanare (Fiddler, Charles, mitmproxy), l-ai închis, dar setarea a rămas în Settings → Proxy;
- Postman preia proxy-ul sistemului, care e configurat pentru rețeaua firmei, iar tu lucrezi de acasă;
- adresa sau portul proxy-ului firmei s-au schimbat;
- proxy-ul cere autentificare și nu o primește.
O greșeală înrudită: cineva pune adresa proxy-ului direct ca baseUrl. Proxy-ul se configurează în Settings, nu în URL-ul cererii.
De ce apare: cauzele frecvente
1Proxy de depanare uitat activ
Settings → Proxy: custom 127.0.0.1:8888 (Fiddler închis)Settings → Proxy: off (sau pornește Fiddler)Fără proces care ascultă pe 8888, tunelul nu se poate deschide.
2Proxy-ul sistemului din altă rețea
Use system proxy: on # proxy.firma.ro, dar lucrezi de acasăUse system proxy: off # sau conectează VPN-ulProxy-ul firmei nu e accesibil din afara rețelei ei.
3Adresa proxy-ului pusă ca baseUrl
baseUrl = http://127.0.0.1:8888baseUrl = https://api.magazin.test
# proxy-ul, dacă e nevoie, în Settings → ProxyCererile trebuie să aibă adresa API-ului; proxy-ul e o setare a clientului.
Repară eroarea, direct în pagină
Un coleg a pus adresa proxy-ului de depanare ca adresă a API-ului: environment-ul activ, „Proxy”, are baseUrl = http://127.0.0.1:8888, iar proxy-ul nu rulează. Proxy-ul nu se configurează în URL. Selectează environment-ul „Dev” și trimite „Listă produse”: trebuie să primești 200.
Indiciu
Adresa API-ului e în environment-ul Dev.
Reparația
Selectează Dev și trimite. Dacă ai nevoie de proxy pe un calculator real, îl configurezi în Settings → Proxy, iar baseUrl rămâne adresa API-ului.
De ce merge
Cu baseUrl pe adresa proxy-ului, cererea mergea direct spre portul 8888, unde nu asculta nimic. Pe Dev, cererea ajunge la API. Proxy-ul, dacă e necesar, stă în setările clientului și se aplică tuturor cererilor fără să schimbe URL-urile. Postman încerca să treacă prin proxy-ul configurat, care nu era disponibil. Cu setările de proxy potrivite rețelei curente, cererea pleacă direct sau prin proxy-ul corect și primește răspuns.
Alte forme ale mesajului
Error: tunneling socket could not be established, statusCode=407Error: tunneling socket could not be established, cause=getaddrinfo ENOTFOUND proxy.firma.ro
Cum o eviți pe viitor
- După o sesiune de depanare cu un proxy local, dezactivează-l din Settings.
- Notează în documentația echipei setările de proxy necesare pentru fiecare rețea.
- În Newman, proxy-ul vine din variabilele
HTTP_PROXY/HTTPS_PROXY; verifică-le în CI. - Când schimbi rețeaua (acasă, birou, VPN), revizuiește setările de proxy din Postman.
Întrebări frecvente
Cum văd ce proxy folosește Postman?
Settings → Proxy: vezi dacă e activ proxy-ul sistemului sau unul custom, cu adresa și portul.
De ce merge în browser?
Browserul poate folosi altă configurare de proxy (de exemplu un fișier PAC) decât cea preluată de Postman.
Erori înrudite
Error: connect ECONNREFUSED 127.0.0.1:3000 Postman a încercat să se conecteze la portul 3000 de pe calculatorul tău, dar acolo nu ascultă niciun server. Pornește API-ul local (npm start, dotnet run etc.) sau alege environment-ul cu adresa serverului care chiar rulează. Error: self-signed certificate in certificate chain Lanțul de certificate al serverului se termină într-o autoritate (CA) pe care Postman nu o cunoaște: de obicei CA-ul intern al firmei sau un proxy care inspectează HTTPS. Adaugă certificatul CA în Settings → Certificates (și --ssl-extra-ca-certs în Newman). Error: write EPROTO ... SSL routines:ssl3_get_record:wrong version number Ai trimis o cerere HTTPS spre un port care vorbește HTTP simplu (sau spre un proxy greșit). Clientul așteaptă un handshake TLS și primește text HTTP. Folosește http:// pentru serverul fără TLS sau portul HTTPS corect. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
