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ță.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Conexiunea s-a făcut, cererea a plecat, dar serverul nu a răspuns în timpul permis, iar Postman a renunțat. ESOCKETTIMEDOUT înseamnă „timeout pe socket”: nu e un status HTTP, ci decizia clientului de a nu mai aștepta.
Timpul maxim vine din:
- Settings al cererii sau setarea globală „Request timeout” din Postman (0 = fără limită);
--timeout-requestîn Newman;timeoutîn opțiunile luipm.sendRequest.
Întrebarea importantă e dacă lentoarea e normală. Un export sau un raport pot dura legitim 10 secunde; atunci mărești limita pentru acea cerere. O listă de produse care durează 30 de secunde e un bug de performanță, iar testul tău a făcut exact ce trebuia.
De ce apare: cauzele frecvente
1Timeout prea mic pentru o operație lentă
Settings → Request timeout: 1000 ms
GET {{baseUrl}}/reports/salesSettings → Request timeout: 10000 msRapoartele și exporturile au nevoie de mai mult timp; limita trebuie potrivită operației.
2Timeout global prea strict în Newman
newman run c.json --timeout-request 500newman run c.json --timeout-request 5000Limita din linia de comandă se aplică tuturor cererilor din rulare.
3Serverul chiar e blocat
GET {{baseUrl}}/products # nu răspunde nici în 60 s# raportează: endpoint, ora, ID de corelare, timpulDacă nici o limită generoasă nu ajunge, e o problemă reală a serverului.
Repară eroarea, direct în pagină
Cererea „Raport lent” (un endpoint care răspunde în aproximativ 3 secunde) are în Settings un timeout de 1000 ms și dă ESOCKETTIMEDOUT. Răspunsul e normal pentru această operație. Mărește timeout-ul cererii la 5000 ms, salvează și trimite: trebuie să primești 200.
Indiciu
Timeout-ul se schimbă din tabul Settings al cererii.
Reparația
În tabul Settings al cererii: Request timeout = 5000 ms. Salvează și trimite.
De ce merge
Serverul răspunde după aproximativ 3 secunde, deci cu limita de 1 secundă Postman renunța înainte de răspuns. Cu 5 secunde, răspunsul ajunge la timp. Limita rămâne totuși finită: dacă endpointul devine și mai lent, vei afla. Timeout-ul din setări e un prag al clientului: Postman renunță după acel număr de milisecunde, chiar dacă serverul ar fi răspuns puțin mai târziu. Cu un prag realist, răspunsul ajunge și testele pot rula.
Alte forme ale mesajului
Error: ETIMEDOUTError: socket timeoutESOCKETTIMEDOUT: serverul nu a răspuns în 1000 ms.
Cum o eviți pe viitor
- Setează limite realiste: mici pentru endpointurile rapide, mai mari pentru rapoarte.
- Folosește Settings la nivel de cerere pentru excepții, nu mări limita pentru toată colecția.
- Scrie și teste pe
responseTime, ca lentoarea să apară ca test picat, cu mesaj clar.
Întrebări frecvente
E la fel cu 504 Gateway Timeout?
Nu. 504 e un răspuns trimis de un proxy dintre tine și server. ESOCKETTIMEDOUT e decizia clientului tău, fără niciun răspuns primit.
Ce înseamnă ETIMEDOUT?
ETIMEDOUT apare la conectare: nici măcar conexiunea nu s-a stabilit. ESOCKETTIMEDOUT apare după conectare, la așteptarea răspunsului.
Erori înrudite
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. 504 Gateway Timeout Gateway-ul (nginx, load balancer) a așteptat prea mult după serverul aplicației și a renunțat. Endpointul e prea lent pentru limita gateway-ului: raportează lentoarea, iar pentru operațiile lungi verifică dacă API-ul are o variantă asincronă (202 + job). AssertionError: expected 3499 to be below 1000 Testul verifică o limită (preț sub 1000), dar răspunsul conține valori peste ea. Înainte să raportezi un bug de filtrare, verifică dacă filtrul a fost trimis corect: un parametru scris greșit (max_price în loc de maxPrice) e ignorat de server. Î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.
