...
Eroare Node.js · Server HTTP, fetch și porturi

Error: connect ECONNREFUSED 127.0.0.1:3000

Pe scurt

Programul tău încearcă să se conecteze la un server care nu ascultă la adresa și portul acela: serverul nu e pornit, s-a oprit sau folosești alt port. Pornește serverul (sau baza de date) și verifică portul din URL. Cu fetch, eroarea apare ca TypeError: fetch failed, cu ECONNREFUSED în cause.

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

Ce înseamnă

ECONNREFUSED („connection refused”) înseamnă că mașina de la adresa dată există și răspunde, dar nimeni nu ascultă pe portul cerut, așa că sistemul a refuzat conexiunea. 127.0.0.1 este calculatorul tău (localhost), iar 3000 portul.

Cu fetch, Node afișează întâi TypeError: fetch failed, iar motivul real e în cause: Error: connect ECONNREFUSED 127.0.0.1:3000. Același mesaj îl vezi la conectarea la o bază de date (connect ECONNREFUSED 127.0.0.1:5432 pentru PostgreSQL, :27017 pentru MongoDB, :6379 pentru Redis) când serviciul nu e pornit.

Verifică trei lucruri: serverul rulează?, pe ce port ascultă (uită-te la mesajul lui de pornire)?, și adresa din client e aceeași? În Docker, localhost din container este containerul însuși, nu calculatorul tău.

De ce apare: cauzele frecvente

1Port greșit în client

Greșit
JavaScript
// serverul: app.listen(8080)
await fetch("http://localhost:3000/api/produse");
Corect
JavaScript
await fetch("http://localhost:8080/api/produse");

Clientul trebuie să folosească exact portul pe care ascultă serverul.

2Serverul nu e pornit

Greșit
JavaScript
node client.js
# TypeError: fetch failed ... ECONNREFUSED
Corect
JavaScript
# terminalul 1
node server.js
# terminalul 2
node client.js

Serverul trebuie să ruleze înainte să-i trimiți cereri.

3Baza de date nu rulează

Greșit
JavaScript
await mongoose.connect("mongodb://localhost:27017/magazin");
Corect
JavaScript
docker run -d -p 27017:27017 mongo
# apoi pornește aplicația

Driverul bazei de date primește același ECONNREFUSED dacă serviciul nu ascultă pe port.

4localhost în Docker

Greșit
JavaScript
DB_HOST=localhost # în containerul aplicației
Corect
JavaScript
DB_HOST=db # numele serviciului din docker-compose

În interiorul unui container, localhost e containerul; celelalte servicii se găsesc după nume.

Repară tu

Repară eroarea, direct în pagină

Serverul ascultă pe portul 8080, dar testul trimite cererea la portul 3000 și primește TypeError: fetch failed cu motivul Error: connect ECONNREFUSED 127.0.0.1:3000. Folosește aceeași constantă pentru port și în server, și în test, ca testul să afișeze lista de produse.

Codul care dă eroarea
JavaScript
const http = require("http");

const PORT = 8080;
const produse = ["Cafea", "Ceai", "Cană"];

const server = http.createServer((req, res) => {
  res.writeHead(200, { "Content-Type": "application/json" });
  res.end(JSON.stringify(produse));
});

server.listen(PORT, async () => {
  console.log(`Server pe portul ${PORT}`);
  const r = await fetch("http://localhost:3000/api/produse");
  console.log(`Produse: ${(await r.json()).join(", ")}`);
  server.close();
});
După reparație, programul afișează
Server pe portul 8080
Produse: Cafea, Ceai, Cană
Indiciu

Construiește URL-ul cu PORT: http://localhost:${PORT}/api/produse.

Alte forme ale mesajului

  • TypeError: fetch failed cause: Error: connect ECONNREFUSED 127.0.0.1:3000
  • Error: connect ECONNREFUSED ::1:3000
  • MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017
  • AxiosError: connect ECONNREFUSED 127.0.0.1:3000

Cum o eviți pe viitor

  • Păstrează adresa serverului într-o singură constantă sau variabilă de mediu (API_URL), folosită și de server și de client.
  • Afișează portul la pornirea serverului: app.listen(PORT, () => console.log(...)).
  • În teste, trimite cererile abia în callback-ul lui listen, când serverul e gata.
  • Tratează eroarea în client cu try/catch și afișează err.cause.

Întrebări frecvente

Ce e ::1 din varianta mesajului?

Este adresa localhost în IPv6. Dacă serverul ascultă doar pe IPv4 (127.0.0.1), iar localhost se rezolvă la ::1, conexiunea e refuzată. Folosește direct 127.0.0.1 în URL sau pornește serverul fără adresă explicită.

Care e diferența față de ENOTFOUND?

La ENOTFOUND numele serverului nu a putut fi găsit deloc (DNS). La ECONNREFUSED adresa există, dar nu ascultă nimeni pe port.

Erori înrudite

← Toate erorile Node.js

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ță Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.