499 是什么
499 是 Nginx 自己定义的日志状态码，不属于 HTTP 标准：当请求已经到达 Nginx、Nginx 还在等待上游或准备响应时，客户端主动断开了连接，Nginx 就在 access log 里记一个 499。它描述的是一种「服务器还在干活，客户端已经走了」的中间态，因此不会作为响应发给客户端。持续出现 499，通常指向后端响应慢、网关或前端超时设置过短，或者用户直接取消操作。
基本信息
| 名称 | 499（Nginx 日志码） |
|---|---|
| 规范 | 非标准，仅出现在 Nginx access log |
| 含义 | 请求已到达，响应发送完之前客户端断开 |
| 常见诱因 | 上游慢、客户端超时、用户取消、移动网络切换 |
| 关键变量 | $request_time 与 $upstream_response_time |
| 相关指令 | proxy_ignore_client_abort、proxy_read_timeout |
典型使用场景
- 统计某个接口的 499 占比，判断是否属于慢接口
- 对比 $request_time 与 $upstream_response_time，区分前后端耗时
- 排查移动端大批量取消：网络切换或前端超时先放弃
- 评估网关超时配置是否过短，导致正常慢请求被中断
- 结合后端日志判断请求是否仍在继续执行
统计 499 并定位慢接口
统计 499 并定位慢接口
# 按 URL 统计 499 次数，找出高频接口
grep ' 499 ' /var/log/nginx/access.log | awk '{print $7}' | sort | uniq -c | sort -rn | head
# 查看这些请求的耗时（需日志格式含 $request_time / $upstream_response_time）
grep ' 499 ' /var/log/nginx/access.log | tail -20
# 自定义日志格式便于分析
# log_format main '$remote_addr $request $status rt=$request_time urt=$upstream_response_time'耗时字段读法
| 字段 | 含义 | 判读 |
|---|---|---|
| $request_time | 从收到首字节到响应完成的整段时间 | 含客户端读取耗时 |
| $upstream_response_time | 与上游连接的耗时（可能多值） | 明显偏大说明后端慢 |
| $status 499 | 客户端在响应前断开 | 不等于服务端主动放弃 |
| 请求是否继续 | 客户端断开后上游常仍在执行 | 会造成无效计算与资源占用 |
| 超时配置 | proxy_read_timeout 等 | 过短会把慢请求切成 499 |
499 是「用户等不及」而不是「服务端拒绝」：它不会返回给客户端，浏览器侧看到的是自己的超时或取消行为。只看服务端监控容易误判为业务请求量为零，实际是请求被客户端提前掐断。
客户端断开后上游默认仍会继续处理，造成无效计算。若业务允许，可用 proxy_ignore_client_abort 配合上游侧的取消机制，在客户端断开时尽早终止后端任务，减少资源浪费。