499 Client Closed Request
Codul 499 apare doar în logurile nginx: clientul (browserul, aplicația mobilă sau un alt serviciu) a închis conexiunea înainte ca serverul să răspundă, pentru că s-a săturat să aștepte. Problema reală e lentoarea: află de ce durează cererile atât de mult.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
499 nu e un cod HTTP standard și clientul nu îl vede niciodată: nginx îl scrie în access log când clientul închide conexiunea în timp ce cererea e încă la server. Clientul a renunțat din propriul timeout (o aplicație mobilă cu 10 secunde, un serviciu care apelează cu timeout de 3 secunde) sau utilizatorul a închis pagina.
Câteva 499 izolate sunt normale. Un val de 499 înseamnă că serverul răspunde mai lent decât acceptă clienții, de obicei pentru că e aproape de limita capacității: peste 80–90% încărcare latența crește brusc, cererile se adună, iar clienții încep să renunțe. Uneori 499 apare și pentru că un alt serviciu are timeout-ul prea mic față de operația normală.
Compară în log durata cererilor cu 499 ($request_time) cu timeout-ul clientului și urmărește încărcarea serverelor la acele momente.
De ce apare: cauzele frecvente
1Servere aproape de capacitatea maximă
# 3 instanțe × 1.000 cereri/s, trafic 2.850 cereri/s
# încărcare 95% -> latența crește de zeci de ori# 5 instanțe × 1.000 cereri/s, trafic 2.850 cereri/s
# încărcare 57%Aproape de 100% cererile stau la coadă înainte să fie procesate. Clienții renunță înainte să primească răspunsul, iar serverul lucrează degeaba.
2Timeout-ul serviciului apelant e mai mic decât operația
// serviciul de comenzi apelează stocul cu timeout de 200 ms
// stocul răspunde normal în 300 ms// timeout ales după latența p99 a serviciului apelat (de ex. 800 ms)
// și optimizarea stocului dacă 300 ms e prea multClientul închide prea devreme conexiunea, chiar dacă serverul ar fi răspuns corect. Timeout-urile se aleg după latența măsurată.
Repară eroarea, direct în pagină
Aplicația mobilă renunță după câteva secunde, iar logul nginx e plin de 499. Serverele lucrează la 95% din capacitate, iar citirile durează mult peste normal. Adu citirile sub 150 ms și toate componentele sub 80%.
Indiciu
Latența crește brusc când o componentă se apropie de 100%; caută-o în tab-ul Simulare.
Reparația
1. Atinge Server aplicație. 2. Setează Instanțe = 5.
Rezultat: încărcare ≈ 57%, citiri în jur de 100 ms, fără 499.
De ce merge
La 95% încărcare, latența proprie a serverului crește de zece ori, iar clienții renunță. Cu 5 instanțe, încărcarea coboară la aproximativ 57%, latența revine la normal și clienții primesc răspunsul înainte de timeout.
Alte forme ale mesajului
499 (în access.log nginx)client prematurely closed connection while sending response to client
Cum o eviți pe viitor
- Ține serverele sub 70–80% încărcare, ca latența să rămână stabilă.
- Urmărește numărul de 499 pe minut: e un indicator timpuriu de lentoare.
- Alege timeout-urile clienților după latența p99 măsurată.
- Pentru cereri care pot fi abandonate, oprește lucrul pe server când clientul s-a deconectat.
Întrebări frecvente
De ce nu văd 499 în browser?
Pentru că browserul a închis deja conexiunea: nu mai primește niciun răspuns. Codul există doar în logul nginx, ca să știi că cererea nu a ajuns la client.
Cererea cu 499 s-a executat totuși pe server?
De multe ori da, până la capăt. De aceea scrierile trebuie să fie idempotente: clientul care reîncearcă după ce a renunțat nu trebuie să dubleze o comandă.
Erori înrudite
504 Gateway Timeout Proxy-ul sau load balancer-ul a așteptat răspunsul serverului mai mult decât îi permite timeout-ul și a renunțat. Serverul nu e neapărat căzut, ci lent: de obicei din cauza bazei de date supraîncărcate, a unei interogări fără index sau a unui serviciu extern apelat sincron. Server supraîncărcat: CPU 100% chiar pe cea mai mare mașină Ai mărit serverul de câteva ori (mai multe nuclee, mai multă memorie), dar traficul tot îl duce la 100% CPU, iar cererile încep să dureze secunde. Scalarea verticală are o limită și un preț care crește repede; treci la scalare orizontală: mai multe instanțe identice în spatele unui load balancer. 503 Service Unavailable Serverul (sau load balancer-ul din fața lui) spune că nu poate trata cererea acum: e supraîncărcat, în mentenanță sau nu are nicio instanță sănătoasă. De obicei repari adăugând capacitate (mai multe instanțe, autoscalare) și verificând de ce instanțele sunt marcate nesănătoase. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
