$upstream_header_time精确反映后端TTFB，从Nginx发起请求到收完响应头为止，排除响应体传输干扰；而$upstream_response_time包含整个响应体接收耗时，易受网络和数据量影响，故前者更准评估后端逻辑启动速度。
$upstream_header_time 是 Nginx 记录后端响应“首字节到达时间”的关键变量，单位为秒（精度毫秒，如 0.042），它从 Nginx 向 upstream 发起请求开始计时，到完整接收到响应头（即 HTTP header 结束）为止。它不包含客户端上传、Nginx 自身处理、响应体传输等环节，因此能干净反映后端服务的 TTFB（Time To First Byte）——也就是后端真正开始处理并返回结果的速度。
为什么用它看首包比 $upstream_response_time 更准？
两者核心区别在于测量终点：
- $upstream_header_time：停在响应头收完（header end），代表后端已生成并发出第一个响应片段，适合评估后端逻辑启动、数据库连接、缓存命中等前置耗时；
- $upstream_response_time：停在响应体收完（body end），包含整个响应内容传输，易受大响应体、网络带宽、缓冲策略影响，不能纯粹反映“首包快不快”。
例如后端返回一个 1KB 的 JSON，但因慢 SQL 卡在构造阶段，$upstream_header_time 会明显升高；而若只是响应体较大（如 5MB 图片），$upstream_header_time 仍可能很低，$upstream_response_time 却拉长——这时首包其实很快，问题不在后端处理逻辑。
如何把它写进日志并稳定采集
必须定义带上下文的 log_format，否则单个数值无法归因：
Audio Upload Aioz Stream Free
下载
基于 AIOZ Stream API 的免费音频上传技能，通过三步流程（Create → Upload Part → Complete）将本地音频文件上传至 AIOZ 流媒体平台。支持默认快速上传方式，使用默认编码配置，上传完成后返回 HLS 流媒体播放链接。使用 API Key (stream-publ...)进行认证。
- 在
http块中定义格式（注意不加引号包裹变量）：log_format ttfb_log '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" "$http_user_agent" ' '"$upstream_addr" $upstream_header_time $upstream_status'; - 在对应
server或location中启用：access_log /var/log/nginx/ttfb.log ttfb_log; - 日志示例：
192.168.5.10 - - [12/May/2026:16:05:22 +0000] "GET /api/user/123 HTTP/1.1" 200 142 "-" "curl/7.68.0" "10.0.2.4:8080" 0.128 200
其中0.128就是首包耗时（128 毫秒），10.0.2.4:8080和200可确认具体节点与状态。
分析时重点关注哪些模式
单看平均值意义有限，要结合分布和异常特征判断真实瓶颈：
- 持续性升高（如 P95 从 80ms → 350ms）：大概率是后端 CPU/内存压力、慢查询、线程池打满或 GC 频繁；
-
偶发尖刺（如正常 50ms，突现 2800ms）且伴随重试：查日志中是否出现逗号分隔值，如
"0.045, 2.780"，说明第一次快速返回，第二次重试才慢——指向某次请求触发了后端瞬时毛刺（如锁竞争、临时资源争用）； -
大量
-或超长值（接近proxy_read_timeout）：不是后端慢，而是连接卡住或无响应，需检查后端进程存活、连接数上限、防火墙中断等； -
同一
$upstream_addr持续偏高：定位到具体实例，可能是该机器负载异常、磁盘 IO 高、或配置不同（如 JVM 参数更激进）。
配合其他变量交叉验证
避免误判，建议至少同步记录以下字段：
- $upstream_connect_time：如果它也同步升高，说明问题在建连阶段（如 TLS 握手慢、后端 accept 队列满、SYN 包丢弃）；
- $request_time：若远大于 $upstream_header_time（比如 1.2s vs 0.06s），说明瓶颈在 Nginx 层（如大请求体上传慢、SSL 处理重、日志写入阻塞）；
- $upstream_queue_time（Nginx ≥ 1.13.9）：非零值表示请求在 upstream 内部队列等待，常见于高并发下后端连接池不足或限流生效。
