Error: connect ECONNREFUSED ::1:8080
Postman a rezolvat localhost la adresa IPv6 ::1, dar serverul ascultă doar pe IPv4 (127.0.0.1). Folosește în URL 127.0.0.1 în loc de localhost sau pornește serverul să asculte și pe IPv6.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
::1 e echivalentul IPv6 al lui 127.0.0.1. Pe sistemele noi (Node 17+, macOS, Windows), numele localhost se rezolvă adesea întâi la ::1. Dacă serverul tău ascultă doar pe 127.0.0.1 (IPv4), conexiunea la ::1:8080 e refuzată, deși serverul merge.
De aici situația confuză: serverul rulează, browserul îl deschide (pentru că încearcă și IPv4), iar Postman spune ECONNREFUSED.
Prima verificare: înlocuiești localhost cu 127.0.0.1 în URL. Dacă merge, problema e IPv4 vs IPv6. Reparația de durată e în server (să asculte pe :: sau pe 0.0.0.0 și ::) sau în environment, unde pui adresa explicită.
De ce apare: cauzele frecvente
1localhost se rezolvă la IPv6
baseUrl = http://localhost:8080baseUrl = http://127.0.0.1:8080Cu adresa IPv4 explicită, nu mai contează ce întoarce rezolvarea lui localhost.
2Serverul ascultă doar pe IPv4
app.listen(8080, "127.0.0.1")app.listen(8080) // ascultă pe toate interfețeleFără adresă, serverele Node ascultă pe :: (cu IPv4 inclus pe majoritatea sistemelor).
3Adresa e scrisă direct în cereri
GET http://localhost:8080/healthGET {{baseUrl}}/healthCu adresa în environment, o schimbi într-un singur loc pentru toate cererile.
Repară eroarea, direct în pagină
Cererea „Health” are adresa scrisă de mână http://localhost:8080/health și dă eroare de conexiune. Environment-ul „Dev” are deja variabila baseUrl cu adresa corectă a API-ului. Schimbă URL-ul cererii ca să folosească {{baseUrl}}, salvează cererea și trimite-o: trebuie să primești 200.
Indiciu
Înlocuiește doar partea cu protocolul, hostul și portul.
Reparația
URL-ul devine:
{{baseUrl}}/healthSalvează (Ctrl+S) și trimite: https://api.magazin.test/health răspunde 200.
De ce merge
Adresa scrisă de mână trimitea cererea spre propriul calculator, unde nu ascultă niciun server. Cu {{baseUrl}}, cererea folosește adresa din environment, iar data viitoare când adresa se schimbă (alt port, IPv4 explicit, alt mediu) o modifici într-un singur loc. Mesajul cu ::1 sau 127.0.0.1 spune doar unde a încercat Postman să se conecteze; după reparație, Console arată adresa nouă și răspunsul primit.
Alte forme ale mesajului
Error: connect ECONNREFUSED ::1:3000
Cum o eviți pe viitor
- Folosește
{{baseUrl}}în cereri și pune adresa locală într-un environment „Local”. - Pentru servere locale, preferă
127.0.0.1când apar probleme de rezolvare. - Când pornești serverul, citește pe ce adresă ascultă (de exemplu
Listening on 127.0.0.1:8080). - Dacă serverul ascultă doar pe IPv4, iar
localhostse rezolvă la::1, scrie explicit adresa în environment.
Întrebări frecvente
De ce browserul deschide aceeași adresă?
Browserele încearcă pe rând IPv6 și IPv4 (Happy Eyeballs), deci găsesc serverul pe IPv4. Clientul folosit de Postman poate încerca doar prima adresă.
Trebuie să dezactivez IPv6?
Nu. E suficient să folosești 127.0.0.1 în URL sau să configurezi serverul să asculte pe toate interfețele.
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: getaddrinfo ENOTFOUND api.magazn.test Numele serverului din URL nu a putut fi găsit în DNS: de obicei e scris greșit, lipsește o parte din domeniu sau serverul e accesibil doar prin VPN. Verifică hostul exact din Console și corectează-l în URL sau în environment. Î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.
