Error: read ECONNRESET
Conexiunea a fost închisă brusc de cealaltă parte (server, proxy, firewall sau antivirus) în timp ce Postman citea răspunsul. Reîncearcă, verifică proxy-ul și VPN-ul, iar dacă apare la rafale de cereri, adaugă o pauză între ele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ECONNRESET înseamnă că cealaltă parte a trimis un „reset” TCP: a închis conexiunea fără ceremonie. Prefixul read arată că s-a întâmplat în timp ce clientul citea răspunsul.
De obicei nu e o problemă a cererii tale, ci a drumului până la server:
- un proxy de firmă sau un antivirus care inspectează traficul HTTPS și taie conexiunile;
- un load balancer sau un gateway care închide conexiunile când primește prea multe cereri într-un timp scurt;
- serverul care repornește chiar atunci;
- o conexiune keep-alive refolosită după ce serverul a închis-o deja.
Dacă apare doar în Collection Runner sau în Newman, când cererile pleacă una după alta fără pauză, o mică întârziere între ele (Delay, --delay-request) rezolvă adesea problema și reduce încărcarea serverului de test.
De ce apare: cauzele frecvente
1Rafală de cereri fără pauză
Runner: Delay 0 ms, 200 de cereriRunner: Delay 200 ms
newman run c.json --delay-request 200Gateway-urile protejate închid conexiunile clienților care trimit prea repede.
2Proxy sau antivirus care inspectează HTTPS
Settings → Proxy: proxy-ul sistemului, cu inspecție SSL# excepție pentru domeniul API-ului în proxy/antivirus
# sau Postman fără proxy pentru mediul de testInspecția HTTPS poate rupe conexiunile lungi sau anumite cereri.
3Serverul repornește
# deploy în timpul rulării testelor# rulează testele după ce deploy-ul s-a terminatUn restart închide toate conexiunile deschise.
Repară eroarea, direct în pagină
Colecția „Magazin” rulează în Runner trei cereri una după alta, fără nicio pauză, iar pe mediul de test partajat gateway-ul închide uneori conexiunile (read ECONNRESET). Rulează colecția în Runner cu un delay de cel puțin 200 ms între cereri; toate testele trebuie să treacă.
Indiciu
Delay se setează în configurarea rulării, lângă numărul de iterații.
Reparația
În Runner: colecția Magazin, Delay = 200 ms, apoi Run.
În Newman, echivalentul este:
newman run Magazin.postman_collection.json --delay-request 200De ce merge
Pauza dintre cereri reduce ritmul la care deschizi conexiuni, deci gateway-ul nu mai consideră clientul abuziv și nu mai taie conexiunile. Pe un mediu partajat, pauza e și o formă de respect față de ceilalți care îl folosesc. ECONNRESET înseamnă că cealaltă parte a închis brusc conexiunea. După reparație, conexiunea rămâne deschisă până la răspuns, iar în Console vezi statusul și timpul cererii.
Alte forme ale mesajului
Error: ECONNRESETError: read ECONNRESET at TLSWrap.onStreamRead
Cum o eviți pe viitor
- Pune o pauză mică între cereri în Runner și Newman pe mediile de test partajate.
- Nu rula testele în timpul unui deploy pe același mediu.
- Când apare intermitent, notează ora și compară cu logurile gateway-ului.
- Când eroarea apare doar pe anumite cereri, compară-le antetele și dimensiunea body-ului cu cele care merg.
Întrebări frecvente
E un bug al API-ului?
Rar. De obicei e rețeaua sau infrastructura dintre tine și API. Devine relevant pentru dezvoltatori când apare constant pe un endpoint anume.
De ce merge când trimit manual?
Manual trimiți rar. În Runner, cererile pleacă una după alta și declanșează limitele infrastructurii.
Erori înrudite
Error: socket hang up Serverul (sau un proxy) a închis conexiunea înainte să trimită un răspuns complet. Cauze tipice: un antet Content-Length scris manual și greșit, HTTP trimis pe un port HTTPS, serverul care cade la cerere sau o limită de timp a proxy-ului. Verifică antetele manuale și logul serverului. 429 Too Many Requests Ai depășit limita de cereri a API-ului (rate limiting). Așteaptă numărul de secunde din antetul Retry-After, pune o pauză între cereri în Runner și Newman și scrie teste care tratează 429 separat de erorile reale. 429 Too Many Requests în Collection Runner fără delay Runner-ul trimite cererile una după alta, fără pauză, și depășește limita de rate a API-ului (aici 10 căutări pe minut). Pune un delay între cereri (câmpul Delay din Runner, --delay-request în Newman) calculat după limită și antetul Retry-After. Î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.
