Error: connect ECONNREFUSED 127.0.0.1:3000
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
// serverul: app.listen(8080)
await fetch("http://localhost:3000/api/produse");await fetch("http://localhost:8080/api/produse");Clientul trebuie să folosească exact portul pe care ascultă serverul.
2Serverul nu e pornit
node client.js
# TypeError: fetch failed ... ECONNREFUSED# terminalul 1
node server.js
# terminalul 2
node client.jsServerul trebuie să ruleze înainte să-i trimiți cereri.
3Baza de date nu rulează
await mongoose.connect("mongodb://localhost:27017/magazin");docker run -d -p 27017:27017 mongo
# apoi pornește aplicațiaDriverul bazei de date primește același ECONNREFUSED dacă serviciul nu ascultă pe port.
4localhost în Docker
DB_HOST=localhost # în containerul aplicațieiDB_HOST=db # numele serviciului din docker-composeÎn interiorul unui container, localhost e containerul; celelalte servicii se găsesc după nume.
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.
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();
});Server pe portul 8080 Produse: Cafea, Ceai, Cană
Indiciu
Construiește URL-ul cu PORT: http://localhost:${PORT}/api/produse.
Reparația
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:${PORT}/api/produse`);
console.log(`Produse: ${(await r.json()).join(", ")}`);
server.close();
});De ce merge
Pe localhost:3000 nu ascultă niciun server, așa că sistemul refuză conexiunea (ECONNREFUSED), iar fetch respinge promisiunea cu fetch failed. Serverul real e pe 8080. Când portul vine dintr-o singură constantă folosită și la listen, și în URL, cele două nu mai pot ajunge să difere. Testul rulează în callback-ul lui listen, adică după ce serverul e gata să primească cereri.
Alte forme ale mesajului
TypeError: fetch failed cause: Error: connect ECONNREFUSED 127.0.0.1:3000Error: connect ECONNREFUSED ::1:3000MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017AxiosError: 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
Error: getaddrinfo ENOTFOUND api.exemplu.ro Numele serverului din URL nu a putut fi găsit în DNS: e scris greșit (locahost, api.exmplu.ro), conține protocolul sau calea în locul greșit, ori nu ai conexiune la internet. Verifică numele de domeniu din URL sau din variabila de mediu. Cu fetch apare ca TypeError: fetch failed. Error: listen EADDRINUSE: address already in use :::3000 Portul pe care vrei să pornești serverul e deja ocupat: o altă instanță a aplicației (pornită în alt terminal sau rămasă agățată) sau alt program îl folosește. Oprește procesul vechi (Ctrl+C, sau găsește-l cu lsof -i :3000) ori pornește serverul pe alt port. UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. Î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.
