...
Eroare System Design · Erori HTTP la proxy și load balancer: 502, 503, 504

499 Client Closed Request

Pe scurt

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ă

Greșit
# 3 instanțe × 1.000 cereri/s, trafic 2.850 cereri/s
# încărcare 95%  ->  latența crește de zeci de ori
Corect
# 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

Greșit
// serviciul de comenzi apelează stocul cu timeout de 200 ms
// stocul răspunde normal în 300 ms
Corect
// timeout ales după latența p99 a serviciului apelat (de ex. 800 ms)
// și optimizarea stocului dacă 300 ms e prea mult

Clientul închide prea devreme conexiunea, chiar dacă serverul ar fi răspuns corect. Timeout-urile se aleg după latența măsurată.

Repară tu

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.

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

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.