Nginx 负载均衡层通过 map 指令优先取客户端 X-Request-ID、缺失时用内置 $request_id 生成唯一请求 ID，自定义 log_format 记录该 ID，并 proxy_set_header 透传至后端，实现全链路日志关联。
在 Nginx 负载均衡层实现基于请求 ID 的全生命周期日志关联，核心是让同一个请求从入口到后端服务全程携带唯一、一致的标识（如 X-Request-ID），并在 Nginx 日志中显式记录该 ID。这样就能将 Nginx 访问日志、后端应用日志、甚至链路追踪系统中的日志串联起来。
生成或透传请求 ID
Nginx 本身不自动生成请求 ID，需通过模块或规则介入：
- 若客户端已携带
X-Request-ID（如前端网关或 SDK 注入），用proxy_set_header X-Request-ID $http_x_request_id;透传，避免覆盖 - 若客户端未提供，可用
ngx_http_secure_link_module或第三方模块（如nginx-request-id）生成 UUID；更常用的是启用nginx-http-realip-module配合map指令 +random或secure_link构造轻量 ID - 推荐做法：用
map指令定义变量，优先取客户端传入的 ID，缺失时用$request_id（Nginx 1.11.0+ 内置变量，基于随机数和时间戳生成，每个请求唯一）示例：map $http_x_request_id $req_id {<br> default $http_x_request_id;<br> "" $request_id;<br>}
配置自定义日志格式并记录请求 ID
修改 log_format，把请求 ID 加入日志字段，确保结构化、易解析：
- 在
http块中定义日志格式，例如：log_format main '$req_id - $remote_user [$time_local] "$request" '<br> '$status $body_bytes_sent "$http_referer" '<br> '"$http_user_agent" "$http_x_forwarded_for"';
- 在
server或location块中启用该格式：access_log /var/log/nginx/access.log main; - 确保
$req_id变量在日志上下文中可访问（定义在http块，作用域覆盖整个配置）
透传请求 ID 到后端服务
仅记录还不够，必须让后端也能拿到同一 ID，才能对齐日志：
- 在
location或上游配置中添加：proxy_set_header X-Request-ID $req_id; - 若后端是微服务（如 Spring Cloud、Go Gin），通常会自动读取
X-Request-ID并注入到 MDC 或 trace context 中，用于打日志 - 注意：避免重复设置（如后端又生成新 ID），建议约定由最外层网关（即 Nginx 层）统一生成并贯穿始终
与链路追踪系统协同（可选增强）
如果已接入 OpenTelemetry、Jaeger 或 SkyWalking，可进一步提升可观测性：
- 将
$req_id作为 trace ID 的一部分（如直接设为 trace ID），或通过proxy_set_header同时透传traceparent等 W3C 标准头 - 使用
nginx-opentelemetry-module（第三方）可原生支持 span 上报，但生产环境需评估稳定性 - 即使不用分布式追踪，保持
X-Request-ID全链路一致，也足以支撑 ELK/Splunk 中按 ID 聚合分析错误、延迟、重试等行为
