getaddrinfo ENOTFOUND api.exmplu.ro
n8n nu a găsit serverul: numele de domeniu din URL nu există sau nu poate fi rezolvat prin DNS (greșeală de scriere, subdomeniu greșit, adresă internă inaccesibilă din n8n). Verifică URL-ul literă cu literă; pentru adrese interne, asigură-te că n8n le poate accesa.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
getaddrinfo ENOTFOUND <domeniu> vine din Node.js, înainte ca cererea să plece: n8n a întrebat DNS-ul ce adresă IP are domeniul și nu a primit răspuns. Uneori n8n îl prezintă ca „The DNS server returned an error, perhaps the server is offline”.
Cauze frecvente: o literă greșită în domeniu (exmplu în loc de exemplu), lipsa unui subdomeniu (exemplu.ro în loc de api.exemplu.ro), spații sau caractere invizibile copiate în URL, un domeniu intern (erp.firma.local) pe care serverul n8n nu îl vede (de exemplu n8n Cloud nu ajunge în rețeaua firmei), sau o problemă de DNS în containerul Docker.
Cum verifici: copiază domeniul din detaliile erorii și deschide-l în browser sau rulează nslookup api.exemplu.ro de pe serverul n8n. Dacă domeniul e corect și merge de pe calculatorul tău, problema e accesul rețelei serverului n8n.
De ce apare: cauzele frecvente
1Literă greșită în domeniu
https://api.exmplu.ro/clientihttps://api.exemplu.ro/clientiUn domeniu scris greșit nu există în DNS.
2Lipsește subdomeniul
https://exemplu.ro/clientihttps://api.exemplu.ro/clientiAPI-ul e pe subdomeniul api; domeniul principal e alt server (sau nu are API).
3Server intern, n8n în cloud
http://erp.firma.local/api/facturi (din n8n Cloud)Expune API-ul printr-o adresă publică securizată sau rulează n8n self-hosted în rețeaua firmeiUn server din cloud nu poate rezolva nume din rețeaua locală a firmei.
Repară eroarea, direct în pagină
Nodul Produse se oprește cu „getaddrinfo ENOTFOUND api.exmplu.ro” (în simulator: „Adresa nu poate fi accesată (ENOTFOUND api.exmplu.ro)”). Corectează domeniul din URL (API-ul demo este pe api.exemplu.ro) și rulează: nodul trebuie să dea cele 6 produse.
Indiciu
Compară literă cu literă domeniul din URL cu cel din tabul Aplicații → API-uri.
Reparația
Produse → URL: https://api.exemplu.ro/produse, apoi Execute workflow: 6 produse, de la Laptop Nova 14 la Căști cu microfon.
De ce merge
Domeniul api.exmplu.ro (lipsește „e”) nu există, deci n8n nu poate afla adresa serverului și nici nu trimite cererea. Cu domeniul corect, api.exemplu.ro, cererea ajunge la API-ul demo, care răspunde cu lista celor 6 produse.
Alte forme ale mesajului
getaddrinfo ENOTFOUNDThe DNS server returned an error, perhaps the server is offlinegetaddrinfo EAI_AGAIN api.exemplu.ro
Cum o eviți pe viitor
- Copiază URL-urile din documentație, nu le rescrie.
- Ține adresa de bază a API-ului într-un singur loc (de exemplu un nod de setări) și construiește restul din ea.
- Pentru servicii interne, verifică de la început unde rulează n8n și ce rețea vede.
EAI_AGAINînseamnă o problemă temporară de DNS: Retry On Fail ajută.
Întrebări frecvente
Care e diferența dintre ENOTFOUND și ECONNREFUSED?
ENOTFOUND: domeniul nu a fost găsit (problemă de nume/DNS). ECONNREFUSED: adresa a fost găsită, dar nimic nu ascultă pe portul respectiv.
În Docker merge google.ro, dar nu serverul firmei. De ce?
Containerul folosește DNS-ul configurat pentru Docker, care poate să nu cunoască domeniile interne. Configurează DNS-ul containerului sau folosește adresa IP.
Erori înrudite
connect ECONNREFUSED 127.0.0.1:3000 Adresa a fost găsită, dar nimic nu acceptă conexiuni pe acel port. Cel mai des: folosești localhost din n8n rulat în Docker (localhost e containerul n8n, nu calculatorul tău) sau serviciul țintă e oprit. Folosește adresa reală a serviciului (host.docker.internal, numele serviciului din Docker Compose sau domeniul public). Invalid URL Textul din câmpul URL nu e o adresă completă: lipsește protocolul (https://), are spații, ghilimele sau o expresie care a dat un rezultat gol. Scrie adresa completă, începând cu https://, și verifică previzualizarea expresiei. The resource you are requesting could not be found API-ul a răspuns 404 Not Found: adresa (calea din URL) nu există sau ID-ul cerut nu există. Verifică URL-ul în documentația API-ului (litere, singular/plural, versiune) și valoarea ID-ului din expresie. Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
