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

Error: getaddrinfo ENOTFOUND api.exemplu.ro

Pe scurt

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

Greșit
JavaScript
await fetch("http://locahost:3000/api/status");
Corect
JavaScript
await fetch("http://localhost:3000/api/status");

Numele trebuie să fie exact; locahost nu există în DNS.

2Protocolul inclus în câmpul host

Greșit
JavaScript
http.get({ host: "https://api.exemplu.ro", path: "/date" });
Corect
JavaScript
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ă

Greșit
JavaScript
API_URL=https://api.exempl.ro node index.js
Corect
JavaScript
API_URL=https://api.exemplu.ro node index.js

Verifică valoarea afișând-o la pornire; o literă lipsă schimbă domeniul.

Repară tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
Stare: ok, versiunea 1.4.0
Indiciu

Uită-te literă cu literă la numele din API_URL.

Alte forme ale mesajului

  • TypeError: fetch failed cause: Error: getaddrinfo ENOTFOUND api.exemplu.ro
  • Error: getaddrinfo ENOTFOUND locahost
  • Error: getaddrinfo EAI_AGAIN api.exemplu.ro
  • MongoServerSelectionError: 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 ping sau nslookup î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

← 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.