含义
当客户端在服务器发送响应之前关闭连接时,nginx 会记录 499。客户端永远看不到这个状态码。
常见原因
- 用户离开页面或取消了请求
- 客户端超时短于服务器处理时间
- 负载均衡器健康检查超时
解决方法
客户端或访问者
如果请求确实需要较长时间,调大客户端或负载均衡器的超时。
网站或 API 的维护者
优化慢接口并排查上游延迟;对必须完成的工作,可考虑 proxy_ignore_client_abort。
响应示例
HTTP/1.1
HTTP/1.1 499 Client Closed Request
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0 规范
不在 IANA 注册表中,由 nginx 使用。
常见问题
› 499 是官方状态码吗?
不是。它是 nginx 的日志代码,不会在网络上发送。
› 为什么 nginx 日志里有很多 499?
客户端或上游负载均衡器先放弃了;把它们的超时与你的响应时间做比较。