TL;DR
- 错误码 499 意味着客户端在 NGINX 返回响应之前关闭了连接；这是一种 NGINX 特定的日志代码，而不是 IETF HTTP 标准状态。
- 常见原因包括浏览器导航、不耐烦的用户、客户端超时、负载均衡器超时、中止的爬虫请求和慢速上游应用。
- 通过关联客户端、代理、负载均衡器和应用日志中的请求 ID，修复 499 错误，然后调整超时预算并减少服务器延迟。
- 在你知道哪个环节关闭了连接以及是否继续工作是安全的之前，不要通过延长超时或
proxy_ignore_client_abort来掩盖症状。
499 错误码是什么意思？
499 错误代码意味着客户端在 NGINX 仍在处理请求时关闭了其连接。NGINX 在其 源代码 中将 NGX_HTTP_CLIENT_CLOSED_REQUEST 定义为 499。
从 NGINX 的角度来看，“客户端”可以是浏览器、移动应用、爬虫、CDN、反向代理或负载均衡器。因此，源日志中的 499 并不证明最终用户故意取消了请求。
为什么会发生错误 499？
错误 499 发生在下游超时或取消发生在上游工作完成之前。
| 原因 | 证据 | 正确响应 |
|---|---|---|
| 用户离开页面 | 请求持续时间短，浏览器取消 | 通常无需修复 |
| 客户端超时过短 | 在客户端超时出现金额 | 减少延迟或调整客户端预算 |
| 负载均衡器超时 | 截止时间与负载均衡器设置相符 | 对齐逐跳超时 |
| 应用程序/数据库慢 | 高上游响应时间 | 分析和优化瓶颈 |
| 超载的源 | 排队、CPU、内存或连接饱和 | 增加容量或限制并发 |
| 爬虫取消请求 | 客户端日志显示中止/重试 | 修复重试和超时策略 |
如何诊断错误代码 499
步骤 1：保留请求标识符
生成或转发一个请求 ID 通过边缘、反向代理和应用。记录请求路径、方法、客户端可见状态、请求时间、上游时间和上游地址。绝不要记录授权头或敏感查询参数。
步骤 2：识别直接客户端
将 NGINX 对等地址和头信息映射到实际的下游环节。如果 CDN 或负载均衡器连接到 NGINX，则其超时（而不是浏览器的超时）可能关闭了套接字。
步骤 3：比较超时预算
按顺序写出超时链：
