Nginx 中通过 map 指令结合 $request_id 实现全链路日志追踪，核心是统一透传、校验和落盘唯一请求标识；需用 map 提取并标准化 X-Request-ID，兜底生成，透传至 upstream 并写入 JSON 格式 access log，且须与后端 MDC 及日志平台协同。
在 Nginx 中利用 map 指令结合 $request_id 实现全链路日志追踪，核心是统一透传和记录唯一请求标识，让前后端、微服务、日志系统能串联同一请求的完整生命周期。关键不在于“生成 ID”，而在于“稳定携带 + 无损透传 + 标准落盘”。
确保 $request_id 全局唯一且稳定生成
Nginx 默认不生成 $request_id，需显式启用：
必须在 http 块中添加：
random_index on; # 部分版本需启用随机模块支持
# 或更推荐（兼容性更好）：
map $request_id $req_id {
"" $binary_remote_addr$pid$connection$request_time;
default $request_id;
}
# 但更稳妥的做法是直接用内置变量生成（无需 map）：
if ($request_id = "") {
set $request_id "${binary_remote_addr}${pid}${connection}${msec}";
}
# ✅ 实际生产推荐：使用 ngx_http_realip_module + lua 或 openresty 的 resty.uuid，或直接依赖 upstream 传递（见下文）
更务实的方案是：由入口网关（如 OpenResty / Spring Cloud Gateway）统一生成 UUID 并注入 X-Request-ID，Nginx 仅做透传与记录，避免自行拼接带来的重复/冲突风险。
用 map 提取并标准化 request_id 字段
当上游已通过 X-Request-ID 头传递时，map 可安全提取、降级兜底、过滤非法值：
- 定义映射规则（放在 http 块）：
map $http_x_request_id $log_request_id {
"" $request_id; # 上游未传，则用 Nginx 自带 request_id（需 ensure_log_format 启用）
~^[a-zA-Z0-9\-_]{8,64}$ $http_x_request_id; # 符合格式才采用
default $request_id; # 其他情况回退
}
该 map 实现三重保障：优先信任上游 ID、校验合法性、兜底自动生成，避免空值或脏数据污染日志链路。
注入到 upstream 请求头并记录到 access log
确保下游服务也能拿到同一 ID，同时本机日志可关联：
- 在 location 或 upstream 配置中透传：
proxy_set_header X-Request-ID $log_request_id; proxy_set_header X-Correlation-ID $log_request_id; # 兼容部分 Java 体系习惯
- 自定义 log_format 包含该字段（推荐 JSON 格式便于 ELK 解析）：
log_format main_json escape=json '{'
'"time_local":"$time_local",'
'"request_id":"$log_request_id",'
'"status":$status,'
'"upstream_addr":"$upstream_addr",'
'"upstream_response_time":"$upstream_response_time",'
'"request_time":$request_time,'
'"http_user_agent":"$http_user_agent"'
'}';
注意：务必用 $log_request_id（map 变量），而非原始 $http_x_request_id，确保兜底逻辑生效。
与后端 & 日志平台协同的关键细节
单靠 Nginx 不构成完整链路，需上下游对齐：
- 后端服务必须读取
X-Request-ID并注入 MDC（Java）/ context（Go/Python），所有日志自动携带 - ELK / Loki 等日志系统需配置字段提取（如
request_id为 top-level 字段），并开启 traceID 聚合查询 - 若使用 OpenTracing / OpenTelemetry，Nginx 层建议升级为 opentracing-openresty 插件，实现 span 注入，不止于日志 ID
- 禁止在 rewrite 阶段修改
$request_id—— 它在请求初始化时已固定，中途 set 无效
