O que significa
O nginx registra 499 quando o cliente fecha a conexão antes de o servidor enviar uma resposta. O cliente nunca vê esse código.
Causas comuns
- O usuário saiu da página ou cancelou a requisição
- Timeout do cliente menor que o tempo de processamento do servidor
- Timeout do health check do balanceador
Como resolver
Se você é o cliente ou visitante
Aumente o timeout do cliente ou do balanceador se as requisições forem legitimamente lentas.
Se você mantém o site ou a API
Acelere endpoints lentos e examine a latência upstream; considere proxy_ignore_client_abort para trabalhos que precisam terminar.
Resposta de exemplo
HTTP/1.1
HTTP/1.1 499 Client Closed Request
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0Especificação
Não está no registro da IANA; usado por nginx.
Perguntas frequentes
› 499 é um código de status oficial?
Não. É um código de log do nginx, não enviado pela rede.
› Por que vejo muitos 499 nos logs do nginx?
Clientes ou balanceadores upstream estão desistindo primeiro; compare os timeouts deles com seus tempos de resposta.