Web 服务器与网关 / 系统课时
怎样区分 Nginx 慢还是后端慢
怎样区分 Nginx 慢还是后端慢
整体请求慢不一定表示代理消耗了很多 CPU,上游时间高也不一定是数据库慢。本篇用可控的后端等待实验对照 request_time 与上游时间,再结合连接、首部、响应体及客户端阶段缩小范围,避免简单相减后直接归因。
学习目标
- 区分整体请求耗时与单次上游交互耗时。
- 用可控后端等待验证日志中的时间信号。
- 结合多次尝试、客户端收发与应用追踪判断下一步。
这些时间是观察区间,不是可相加的清单
request_time 覆盖客户端请求开始到响应结束并记录日志;upstream_response_time 观察与上游响应有关的整体时间。upstream_connect_time 反映连接建立,HTTPS 上游还含握手;upstream_header_time 反映取得响应首部所需时间。

连接、首部与整个响应时间存在范围重叠,不能把三个数相加当总耗时。上游时间还可能受网络、请求转发和应用排队等影响,不等于某一段函数执行时间。定义见 Nginx 上游时间变量。
启动有明确等待点的后端
实验需要 Linux、Python 3、Nginx 1.28、curl,以及空闲的本机 8080 和 9001。以下完整程序保存为 timing_app.py,在独立终端执行 python3 timing_app.py,Ctrl+C 结束:
import time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
class App(BaseHTTPRequestHandler):
def do_GET(self):
if self.path == "/slow":
time.sleep(0.35) # 明确发生在返回响应首部前。
data = b"ok\n"
self.send_response(200)
self.send_header("Content-Length", str(len(data)))
self.end_headers()
self.wfile.write(data)
if __name__ == "__main__":
ThreadingHTTPServer(("127.0.0.1", 9001), App).serve_forever()预期结果:后端等待请求,/slow 在首部前等待约 0.35 秒,/fast 不主动等待。调度与系统负载会影响实际耗时。
为同一次请求记录整体与上游时间
先创建本次实验的 /tmp/nginx-latency-lab 日志目录,确保 Master 可打开它。以下片段示例放入 http,依赖已启动的后端:
log_format latency_json escape=json
'{"uri":"$uri","status":"$status","id":"$request_id",'
'"rt":"$request_time","ua":"$upstream_addr",'
'"uct":"$upstream_connect_time","uht":"$upstream_header_time",'
'"urt":"$upstream_response_time"}';
server {
listen 127.0.0.1:8080;
server_name timing.test;
access_log /tmp/nginx-latency-lab/access.ndjson latency_json;
location / {
proxy_set_header X-Request-ID $request_id;
proxy_pass http://127.0.0.1:9001;
}
}检查并重载后执行:
curl --noproxy '*' --resolve timing.test:8080:127.0.0.1 -sS -w 'client_total=%{time_total}\n' http://timing.test:8080/fast
curl --noproxy '*' --resolve timing.test:8080:127.0.0.1 -sS -w 'client_total=%{time_total}\n' http://timing.test:8080/slow
tail -n 2 /tmp/nginx-latency-lab/access.ndjson预期两次均输出 ok、状态日志为 200;/slow 的 uht 与 urt 应明显包含这段约 0.35 秒的等待,rt 通常也接近它们。本例响应很小、网络为回环;时间为动态值,不能要求每次恰为 0.350。
依据信号选择下一层证据
| 观察 | 优先检查 |
|---|---|
| uct 高 | 上游连接、网络、TLS 握手和监听压力 |
| uht 明显高于连接时间 | 请求转发、上游排队与首部前应用处理 |
| urt 比 uht 大很多 | 上游响应体生成与传输、缓冲及背压 |
| rt 高而上游时间较低 | 客户端上传或下载、代理缓冲、限速与内部处理 |
这张表只缩小排查方向。慢客户端、代理缓冲、多个上游尝试和内部跳转会改变时间关系,rt - urt 不能直接称为 Nginx CPU 耗时。上游字段含多个值时,先按地址与尝试状态对齐,不要直接转成单个数字。
对真实故障按请求标识关联应用日志或追踪,再核对机器资源和网络数据。给后端加大超时只会改变等待上限,不会解释等待发生在哪里;先复现并收集阶段证据,再调整配置。