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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din sistemul de operare, nu din API: ECONNREFUSED înseamnă că adresa există, dar conexiunea a fost refuzată, pentru că pe acel port nu ascultă nimic. 127.0.0.1 e propriul calculator (localhost), iar 3000 e portul din URL.
În panoul de răspuns, Postman afișează „Could not send request” cu acest detaliu dedesubt. Nu există status HTTP, nici body, pentru că cererea n-a ajuns la niciun server.
Cazurile tipice: serverul de dezvoltare nu e pornit sau a căzut la pornire, ascultă pe alt port (8080 în loc de 3000), environment-ul selectat e „Local” deși voiai „Dev” sau rulezi în Docker și portul nu e publicat spre calculator. Verifică în Console ce URL a plecat efectiv, după înlocuirea variabilelor.
De ce apare: cauzele frecvente
1Serverul local nu e pornit
GET http://localhost:3000/products
# terminalul API-ului e închisnpm start # sau dotnet run, mvn spring-boot:run
GET http://localhost:3000/productsFără proces care ascultă pe port, sistemul refuză imediat conexiunea. Pornit serverul, aceeași cerere primește răspuns.
2Environment-ul greșit e selectat
Environment: Local (baseUrl = http://localhost:3000)Environment: Dev (baseUrl = https://api.magazin.test)Cererea folosește {{baseUrl}} din environment-ul selectat. Pe „Local” trimite spre calculatorul tău.
3Portul nu se potrivește
baseUrl = http://localhost:3000
# serverul scrie: Listening on port 8080baseUrl = http://localhost:8080Serverul afișează la pornire portul real. Portul din URL trebuie să fie exact acela.
4Portul containerului nu e publicat
docker run magazin-apidocker run -p 3000:3000 magazin-apiFără -p, portul din container nu e accesibil de pe calculator, deci localhost:3000 refuză conexiunea.
Repară eroarea, direct în pagină
Cererea „Listă produse” a dat Error: connect ECONNREFUSED 127.0.0.1:3000, pentru că environment-ul selectat e „Local”, iar pe calculator nu rulează niciun server. API-ul demo e pe environment-ul „Dev”. Repară cererea ca să primească 200 OK.
Indiciu
Uită-te la selectorul de environment din dreapta-sus.
Reparația
Alege environment-ul Dev din selectorul din dreapta-sus, apoi trimite din nou cererea:
GET {{baseUrl}}/products → https://api.magazin.test/products → 200 OKDe ce merge
{{baseUrl}} se înlocuiește cu valoarea din environment-ul selectat. Pe „Local” valoarea e http://localhost:3000, unde nu ascultă nimic, deci sistemul refuză conexiunea. Pe „Dev”, cererea ajunge la serverul demo și primește 200. Pe un proiect real, alternativa este să pornești serverul local.
Alte forme ale mesajului
Error: connect ECONNREFUSED 127.0.0.1:8080Error: connect ECONNREFUSED 0.0.0.0:5000Could not send request
Cum o eviți pe viitor
- Verifică întâi că serverul răspunde: o cerere simplă la
/health. - Ține adresele în environment-uri cu nume clare (Local, Dev, Staging) și uită-te la selector înainte de Send.
- Citește portul din logul de pornire al serverului, nu din memorie.
- În Docker, publică portul (
-p 3000:3000) și verifică cudocker ps.
Întrebări frecvente
De ce merge în browser și nu în Postman?
De obicei nu e aceeași adresă: browserul deschide alt port sau alt host. Compară URL-ul exact din Console cu cel din bara browserului.
Ce diferență e între ECONNREFUSED și ENOTFOUND?
ENOTFOUND: numele serverului nu a putut fi găsit în DNS. ECONNREFUSED: adresa a fost găsită, dar pe port nu ascultă nimic.
Erori înrudite
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. 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. Could not send request Mesajul general din panoul de răspuns când cererea nu a primit niciun răspuns HTTP. Detaliul de sub el (ECONNREFUSED, ENOTFOUND, timeout, Invalid URL) spune cauza reală; deschide Console ca să vezi URL-ul final și eroarea completă. Î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.
