Nginx透传X-Trace-ID可在5分钟内闭环验证：先在log_format中添加$http_x_trace_id并开启underscores_in_headers，再用curl带标头请求并查access日志，接着配置proxy_set_header透传至后端，最后多级代理逐跳比对日志一致性。
直接在 Nginx 配置中加日志字段并发起一次带标头的请求，就能快速验证透传是否生效——不需要改后端、不依赖链路系统，5 分钟内可完成闭环测试。
第一步：在 access_log 中显式记录目标 Header
修改 log_format，加入你要透传的标头变量（注意命名规范）：
- 若透传的是
X-Trace-ID，对应变量是$http_x_trace_id - 若透传的是
traceparent，对应变量是$http_traceparent - 若用了下划线命名（如
X_Trace_ID），必须先开启underscores_in_headers on;，否则该变量始终为空
示例配置：
log_format trace_log '[$time_local] $remote_addr "$request" $status "$http_x_trace_id" "$upstream_http_x_trace_id"';第二步：用 curl 模拟带标头的请求并观察日志
在终端执行：
curl -H "X-Trace-ID: abc123def456" http://your-nginx-domain/api/test然后立刻查 Nginx access 日志：
预期输出中应包含 "abc123def456" —— 这说明 Nginx 成功接收并记录了该标头。
第三步：检查 upstream 是否收到（即是否真正透传）
在对应 location 块中确认已配置透传指令：
-
proxy_set_header X-Trace-ID $http_x_trace_id;（从客户端读取并转发） - 或更稳妥的写法：
proxy_set_header X-Trace-ID $trace_id;（配合map指令做兜底）
接着让后端服务打印所有收到的请求头（例如 Node.js 中 console.log(req.headers)，Java Spring Boot 中打日志输出 request.getHeader("X-Trace-ID")），确认值是否为 abc123def456。
第四步：验证跨跳一致性（多级 Nginx 或网关场景）
如果请求路径含多个代理层（如 CDN → 入口 Nginx → 内部 Nginx → 后端），需逐跳检查：
- 每层 Nginx 的 access_log 都加
$http_x_trace_id字段 - 每层都配置
proxy_set_header X-Trace-ID $http_x_trace_id;（避免覆盖） - 对比各层日志中的值是否完全一致；若中间某层为空或变掉，说明该层未启用
underscores_in_headers或未正确映射变量
