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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ETIMEDOUT la connect înseamnă că pachetele de conectare au plecat, dar nu a venit niciun răspuns, nici măcar un refuz. Diferența față de ECONNREFUSED e importantă: acolo serverul spune „nu”, aici nu spune nimic.
Cauze frecvente:
- o adresă IP privată (
10.x,192.168.x,172.16–31.x) accesibilă doar din rețeaua firmei; - un firewall care aruncă pachetele spre acel port;
- VPN-ul deconectat;
- un server oprit, pe care rețeaua nu îl mai anunță ca indisponibil.
Un IP scris direct în cerere e de obicei semn că cineva a copiat adresa dintr-un log. Numele serverului (api.magazin.test) e mai sigur: funcționează și după o mutare, iar certificatul HTTPS e emis pe nume, nu pe IP.
De ce apare: cauzele frecvente
1IP intern folosit din afara rețelei
GET https://10.0.0.5/healthGET {{baseUrl}}/health # baseUrl = https://api.magazin.testAdresele private nu sunt rutate pe internet.
2Portul e blocat de firewall
GET https://api.magazin.test:8443/healthGET https://api.magazin.test/healthRețelele de firmă permit de obicei doar porturile standard (443, 80).
3VPN deconectat
# VPN off
GET https://api.intern.firma.local/health# VPN on
GET https://api.intern.firma.local/healthRutele spre rețeaua internă există doar cu VPN-ul activ.
Repară eroarea, direct în pagină
Cererea „Health” trimite spre adresa internă https://10.0.0.5/health, inaccesibilă de aici. Înlocuiește IP-ul cu {{baseUrl}} (environment-ul Dev are adresa publică a API-ului), salvează cererea și trimite-o: trebuie să primești 200.
Indiciu
Păstrează calea /health, schimbă doar adresa serverului.
Reparația
{{baseUrl}}/healthSalvează și trimite.
De ce merge
IP-ul privat nu e accesibil din rețeaua ta; în simulator vezi o eroare de rezolvare, iar pe un calculator real, de obicei ETIMEDOUT după zeci de secunde. Numele public al serverului, ținut în environment, ajunge la API și funcționează și cu certificatul HTTPS.
Alte forme ale mesajului
Error: connect ETIMEDOUT 192.168.1.20:8080Error: ETIMEDOUT
Cum o eviți pe viitor
- Folosește nume de server în environment-uri, nu IP-uri.
- Notează pentru fiecare mediu dacă e nevoie de VPN.
- Pentru o verificare rapidă,
curl -v https://adresa/healthdin terminal îți arată dacă problema e de rețea sau din Postman. - Când un host nu răspunde deloc, verifică întâi VPN-ul, firewall-ul și dacă adresa e publică sau internă.
Întrebări frecvente
De ce durează mult până apare eroarea?
Clientul așteaptă un răspuns la conectare până la limita sistemului, adesea zeci de secunde, pentru că nimeni nu refuză explicit.
Diferența față de ESOCKETTIMEDOUT?
ETIMEDOUT: conexiunea nu s-a stabilit. ESOCKETTIMEDOUT: conexiunea există, dar răspunsul nu a venit în timp.
Erori înrudite
Error: ESOCKETTIMEDOUT Serverul nu a trimis niciun răspuns în timpul maxim setat pentru cerere. Mărește timeout-ul (Settings al cererii, Settings global sau --timeout-request în Newman) dacă operația e lentă în mod normal, altfel raportează lentoarea ca problemă de performanță. 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. Error: Hostname/IP does not match certificate's altnames: Host: 10.0.0.5. is not in the cert's altnames Certificatul serverului e emis pentru un nume (de exemplu api.magazin.test), dar tu te conectezi prin alt nume sau prin IP. Folosește în URL exact numele din certificat, de obicei prin {{baseUrl}}, nu adresa IP. Î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.
