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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
getaddrinfo este funcția sistemului care transformă un nume (api.exemplu.ro, localhost) într-o adresă IP. ENOTFOUND înseamnă că numele nu există sau nu a putut fi rezolvat. Conexiunea nici n-a început: Node nu știe unde să trimită cererea.
Cele mai dese cauze: o greșeală de scriere în domeniu (locahost, api.exmplu.ro), un URL construit greșit (de exemplu http://http://... sau host cu https:// inclus când librăria vrea doar numele), o variabilă de mediu cu adresa greșită, ori lipsa conexiunii la internet sau un DNS blocat (VPN, proxy de firmă). În Docker apare când folosești numele unui serviciu care nu e în aceeași rețea.
Cu fetch vezi întâi TypeError: fetch failed, iar motivul e în cause.
De ce apare: cauzele frecvente
1Domeniu scris greșit
await fetch("http://locahost:3000/api/status");await fetch("http://localhost:3000/api/status");Numele trebuie să fie exact; locahost nu există în DNS.
2Protocolul inclus în câmpul host
http.get({ host: "https://api.exemplu.ro", path: "/date" });http.get({ host: "api.exemplu.ro", path: "/date" });
// sau: fetch("https://api.exemplu.ro/date")La opțiunea host se dă doar numele, fără https:// și fără cale.
3Adresă dintr-o variabilă de mediu greșită
API_URL=https://api.exempl.ro node index.jsAPI_URL=https://api.exemplu.ro node index.jsVerifică valoarea afișând-o la pornire; o literă lipsă schimbă domeniul.
Repară eroarea, direct în pagină
Programul pornește un server local și îi verifică starea, dar URL-ul din API_URL are numele localhost scris greșit, iar fetch dă TypeError: fetch failed cu motivul Error: getaddrinfo ENOTFOUND locahost. Corectează adresa, ca testul să afișeze starea serverului.
const http = require("http");
const API_URL = "http://locahost:3000";
const server = http.createServer((req, res) => {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ stare: "ok", versiune: "1.4.0" }));
});
server.listen(3000, async () => {
const r = await fetch(`${API_URL}/api/status`);
const date = await r.json();
console.log(`Stare: ${date.stare}, versiunea ${date.versiune}`);
server.close();
});Stare: ok, versiunea 1.4.0
Indiciu
Uită-te literă cu literă la numele din API_URL.
Reparația
const http = require("http");
const API_URL = "http://localhost:3000";
const server = http.createServer((req, res) => {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ stare: "ok", versiune: "1.4.0" }));
});
server.listen(3000, async () => {
const r = await fetch(`${API_URL}/api/status`);
const date = await r.json();
console.log(`Stare: ${date.stare}, versiunea ${date.versiune}`);
server.close();
});De ce merge
Înainte de conectare, Node cere sistemului adresa IP a numelui din URL prin getaddrinfo. locahost nu e un nume cunoscut, așa că rezolvarea eșuează cu ENOTFOUND și cererea nici nu pleacă. localhost este numele standard al propriului calculator (adresa 127.0.0.1), deci cererea ajunge la serverul pornit pe portul 3000. Când adresa vine dintr-o variabilă, afișeaz-o la pornire: greșelile de o literă se văd imediat.
Alte forme ale mesajului
TypeError: fetch failed cause: Error: getaddrinfo ENOTFOUND api.exemplu.roError: getaddrinfo ENOTFOUND locahostError: getaddrinfo EAI_AGAIN api.exemplu.roMongoServerSelectionError: getaddrinfo ENOTFOUND cluster0.mongodb.net
Cum o eviți pe viitor
- Ține adresele serviciilor într-o singură variabilă de mediu și afișeaz-o la pornire.
- Construiește URL-urile cu
new URL(cale, baza), ca să eviți dublarea protocolului sau a barelor. - Verifică un domeniu din terminal cu
pingsaunslookupînainte să-l pui în cod. - Tratează erorile de rețea cu
try/catchși afișeazăerr.cause.code.
Întrebări frecvente
Ce înseamnă EAI_AGAIN?
Serverul DNS nu a răspuns la timp, de obicei din cauza conexiunii la internet. Reîncearcă sau verifică rețeaua; nu e neapărat o problemă de nume.
Cum văd motivul exact când folosesc fetch?
Prinde eroarea și afișează err.cause: acolo găsești code (ENOTFOUND, ECONNREFUSED) și hostname.
Erori înrudite
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. 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.
