Error: getaddrinfo EAI_AGAIN api.magazin.test
DNS-ul nu a putut răspunde acum (eroare temporară): nu ai internet, VPN-ul a căzut, serverul DNS e indisponibil sau rulezi într-un container fără DNS. Verifică rețeaua și reîncearcă; dacă persistă, problema e în configurarea DNS, nu în API.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
EAI_AGAIN înseamnă „încearcă din nou”: căutarea numelui în DNS a eșuat temporar. Spre deosebire de ENOTFOUND, unde DNS-ul spune clar că numele nu există, aici nu a primit niciun răspuns valid.
Apare tipic când:
- conexiunea la internet a căzut sau e foarte instabilă;
- un domeniu intern se rezolvă doar prin VPN, iar VPN-ul s-a deconectat;
- rulezi Newman într-un container sau într-un runner CI fără acces la DNS;
- un proxy sau un firewall blochează traficul DNS.
Dacă reîncerci după câteva secunde și merge, a fost o problemă de rețea. Dacă apare constant doar pentru un domeniu, verifică dacă acel domeniu e intern și accesibil din locul în care rulezi.
De ce apare: cauzele frecvente
1VPN-ul nu e conectat
Environment: Intern (baseUrl = https://api.intern.magazin.local)
# VPN deconectat# conectează VPN-ul sau folosește un mediu public
Environment: Dev (baseUrl = https://api.magazin.test)Numele interne se rezolvă doar prin DNS-ul rețelei firmei.
2Container fără DNS
docker run --network none newman-image ...docker run newman-image ... # rețeaua implicită, cu DNSFără rețea configurată, containerul nu poate rezolva niciun nume.
3Rulare CI în altă rețea
newman run colectie.json -e intern.json # runner publicnewman run colectie.json -e staging-public.json
# sau un runner self-hosted în rețeaua firmeiUn runner CI public nu vede domeniile interne.
Repară eroarea, direct în pagină
Environment-ul selectat, „Intern”, trimite cererile spre un domeniu care se rezolvă doar prin VPN-ul firmei, deci primești o eroare de DNS. Lucrează pe API-ul public: selectează environment-ul „Dev” și trimite din nou „Listă produse”, care trebuie să dea 200.
Indiciu
Schimbă environment-ul activ, nu cererea.
Reparația
Alege Dev din selectorul de environment și trimite din nou cererea.
De ce merge
Domeniul api.intern.magazin.local nu poate fi rezolvat din afara rețelei firmei; în simulator vezi ENOTFOUND, iar pe un calculator real, cu VPN-ul căzut, vezi adesea EAI_AGAIN. Environment-ul Dev are o adresă publică, rezolvabilă de oriunde, deci cererea ajunge la API. EAI_AGAIN e o eroare temporară de DNS, nu una de configurare a cererii. După ce rezolvarea numelui funcționează din nou, aceeași cerere ajunge la server fără nicio altă modificare.
Alte forme ale mesajului
Error: getaddrinfo EAI_AGAIN registry.npmjs.org
Cum o eviți pe viitor
- Folosește pentru CI adrese accesibile din locul unde rulează pipeline-ul.
- Pentru mediile interne, documentează că e nevoie de VPN.
- În Newman, o eroare de rețea apare ca cerere „errored”; rulează din nou o dată înainte să cauți bug-uri în API.
Întrebări frecvente
E o eroare a API-ului?
Nu. Cererea nu a ajuns la API; problema e la rezolvarea numelui, pe calculatorul sau în rețeaua de unde trimiți.
De ce apare doar în Docker?
Containerul folosește alt DNS decât calculatorul. Verifică rețeaua containerului și fișierul /etc/resolv.conf din el.
Erori înrudite
Error: getaddrinfo ENOTFOUND api.magazn.test Numele serverului din URL nu a putut fi găsit în DNS: de obicei e scris greșit, lipsește o parte din domeniu sau serverul e accesibil doar prin VPN. Verifică hostul exact din Console și corectează-l în URL sau în environment. Error: connect ETIMEDOUT 10.0.0.5:443 Conexiunea la server nu s-a putut stabili în timp: adresa IP nu e accesibilă din rețeaua ta (firewall, VPN, IP privat) sau serverul e oprit. Verifică dacă folosești adresa corectă, de preferat numele public al serverului, nu un IP intern. Newman: getaddrinfo ENOTFOUND {{baseurl}} (lipsește -e) Newman a rulat colecția fără environment, deci {{baseUrl}} nu s-a rezolvat și a fost folosit ca nume de server. Adaugă -e cu environment-ul exportat (sau --env-var "baseUrl=..."). Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
