Nginx可通过透传或生成Trace ID实现全链路追踪：优先读取X-Trace-ID请求头，缺失时fallback至$request_id；用map定义$trace_id变量；在log_format中加入该变量；并proxy_set_header透传至后端。
要在 Nginx 中记录请求的唯一 Trace ID 用于全链路追踪，核心思路是：**让 Nginx 生成或透传一个全局唯一的标识（如 X-Trace-ID），并在 access_log 中将其写入日志字段**。这需要结合请求头处理、变量定义和日志格式定制三步完成。
1. 生成或透传 Trace ID
Nginx 本身不内置分布式 Trace ID 生成器，但可通过以下方式之一获取：
-
上游服务注入：若前端有网关（如 Spring Cloud Gateway、Envoy）或应用层已生成 Trace ID（如通过 Sleuth/Zipkin、OpenTelemetry），通常会携带
X-Trace-ID或traceparent请求头。Nginx 可直接读取并复用。 -
Nginx 自行生成（简单场景）：使用
ngx_http_random_index_module不支持 UUID，但可借助lua-nginx-module（OpenResty）或perl模块生成；更轻量的方式是用map+$request_id（Nginx 内置变量，每个请求唯一，格式类似5a4c9e2a7b3d4f1e8c6a0b2d）作为 Trace ID 的基础。
2. 定义日志变量（关键步骤）
在 http 块中定义一个变量，优先取请求头中的 Trace ID，缺失时 fallback 到 $request_id：
map $http_x_trace_id $trace_id {
default $http_x_trace_id;
'' $request_id;
}
这样，$trace_id 就始终有值，且保持请求粒度唯一性。
3. 自定义日志格式并启用
扩展 log_format，加入 $trace_id 字段：
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time $upstream_response_time '
'$trace_id';
然后在 server 或 location 块中指定该格式：
access_log /var/log/nginx/access.log main;
4. （可选）向后端透传 Trace ID
为实现全链路贯通，需将 Trace ID 传递给后端服务：
- 如果使用
$trace_id作为统一标识，可在location中添加：
proxy_set_header X-Trace-ID $trace_id;
后端应用即可读取该头继续传递或打点。注意：若后端依赖 traceparent（W3C 标准），需用 Lua 或 OpenResty 构造兼容格式，纯 Nginx 配置无法生成符合规范的 traceparent 字符串。
不复杂但容易忽略的是变量作用域和 fallback 逻辑——确保 map 定义在 http 块顶层，且 $request_id 在所有请求中稳定可用。这样每条 access log 行就自带可关联的 Trace ID，配合 ELK 或 Loki 即可做跨服务检索与链路还原。
