Web 服务器与网关 / 系统课时

499 状态码为什么经常出现在日志

499 状态码为什么经常出现在日志

499 常出现在访问日志中,却不是客户端收到的一张错误响应。本篇让客户端在后端返回首部前主动超时退出,观察 Nginx 记录的状态,再对照完整等待成功,分辨用户离开、代理时限与后端慢响应的关系。

学习目标

  • 解释 Nginx 记录 499 时客户端连接的状态。
  • 用有限的本机请求复现提前断开及成功对照。
  • 结合耗时和前方代理定位谁先结束等待。

客户端离开后不能再收到正常响应

499 是 Nginx 用来标记客户端提前关闭请求的非标准状态,源码中名为 NGX_HTTP_CLIENT_CLOSED_REQUEST。它常见于等待响应期间连接已经断开;不能解释成 Nginx 把 HTTP 499 页面发给用户。定义见 Nginx 1.28.3 请求状态源码。

客户端先结束等待,Nginx 记录 499,后端工作仍可能继续

Nginx 所说的客户端可能是浏览器,也可能是 CDN、网关或另一个代理。用户取消、前方超时和网络断开都可能成为线索,单条 499 无法证明是哪一种。

准备两秒后才响应的本机后端

实验需要 Linux、Python 3、curl、Nginx 1.28,空闲回环 8080 与 9001。以下完整程序保存为 abort_app.py,在独立终端执行 python3 abort_app.py:

python
import time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

class App(BaseHTTPRequestHandler):
    def do_GET(self):
        time.sleep(2)
        try:
            self.send_response(200)
            self.send_header("Content-Length", "3")
            self.end_headers()
            self.wfile.write(b"ok\n")
        except (BrokenPipeError, ConnectionResetError):
            pass

if __name__ == "__main__":
    ThreadingHTTPServer(("127.0.0.1", 9001), App).serve_forever()

预期结果:后端等待请求,并在两秒后尝试返回首部与正文。这个教学程序不实现业务取消;Ctrl+C 结束。

让客户端先结束等待

创建新的 /tmp/nginx-499-lab 日志目录。以下片段示例放入 http;读取上限明确大于后端等待,避免把实验混成 504:

nginx
log_format abort_log '$request_method $uri status=$status rt=$request_time';
server {
    listen 127.0.0.1:8080;
    server_name abort.test;
    access_log /tmp/nginx-499-lab/access.log abort_log;
    location / {
        proxy_read_timeout 5s;
        proxy_ignore_client_abort off;
        proxy_pass http://127.0.0.1:9001;
    }
}

检查并重载后执行:

bash
# 只请求隔离实验站;超时失败是本例预期结果。
curl --noproxy '*' --resolve abort.test:8080:127.0.0.1 --max-time 0.3 -sS http://abort.test:8080/slow

预期 curl 以退出码 28 结束,未收到正常 HTTP 响应;稍后日志出现 /slow status=499,rt 约为客户端等待时间。不能把 curl 的本地退出码与 HTTP 状态混为一谈。

再执行完整等待对照:

bash
curl --noproxy '*' --resolve abort.test:8080:127.0.0.1 --max-time 4 -sS -w 'status=%{http_code}\n' http://abort.test:8080/slow
tail -n 2 /tmp/nginx-499-lab/access.log

预期输出 ok 与 status=200,日志能看到提前离开的 499 和完整等待的 200 两类记录,时间随调度变化。

取消连接不等于取消业务

proxy_ignore_client_abort off 允许 Nginx 在客户端离开后关闭对应上游连接,但应用是否停止工作取决于其取消机制。已经执行的写入不保证回滚,不能因为看到 499 就自动重试所有交易。

关联请求标识、请求耗时、应用完成时间与前方代理日志。若 499 集中在固定秒数附近,核对哪一层的超时预算先到;若只是个别用户取消,也不能仅据计数断言服务故障。

把该参数改成 on 只是改变连接处理,不会让已经离开的用户回来,还可能继续占用资源。参数说明见 Nginx 客户端断开处理。应先确定业务取消、幂等与时限策略,再调整链路预算。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

499 状态码为什么经常出现在日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通