Nginx 通过内置 $request_id 变量生成32位十六进制请求ID，配合 map 和 proxy_set_header 指令透传 X-Request-ID 至上游服务，支持链路追踪与日志关联，并可通过 log_format 写入 access log；旧版本可降级使用 $pid-$msec-$remote_addr 组合模拟。
在 Nginx 中，可以通过 proxy_set_header 指令将请求唯一 ID（如 X-Request-ID）传递给上游服务，既便于链路追踪，也利于日志关联和问题排查。
生成并设置唯一请求 ID
Nginx 本身不自动生成 UUID，但可通过 map 指令结合 $request_id 变量（由 ngx_http_core_module 提供）来实现。该变量在每个请求生命周期内自动创建一个 32 位十六进制字符串（如 12a3b4c5678901234567890123456789），无需额外模块。
在 http 块中定义：
map $request_id $req_id {
default $request_id;
}然后在 location 或 upstream 上下文中使用：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
proxy_set_header X-Request-ID $req_id;
确保上游服务能接收并透传
若请求经过多层代理（如 Nginx → Nginx → 应用），需避免 ID 被覆盖或丢失：
- 上游 Nginx 若也做反向代理，应配置
proxy_pass_request_headers on;（默认开启，通常无需显式设置） - 建议统一使用
X-Request-ID标准头，避免与应用自动生成的 ID 冲突 - 若上游应用未主动记录该头，需在应用层读取并写入日志（如 Node.js 中
req.headers['x-request-id']）
配合日志格式增强可观测性
将请求 ID 写入 access log，可快速定位单次请求的完整处理路径：
log_format main '$req_id - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';再在 server 或 location 中启用：
access_log /var/log/nginx/access.log main;
可选：兼容缺失 request_id 的旧版本 Nginx
若使用低于 1.11.0 的 Nginx（无内置 $request_id），可借助 ngx_http_realip_module 或第三方模块（如 nginx-http-rdns）生成 ID，但更推荐升级 Nginx 版本。也可用 $pid-$msec-$remote_addr 等组合模拟唯一性（仅作临时方案，不保证全局唯一）：
set $my_req_id "$pid-$msec-$remote_addr"; proxy_set_header X-Request-ID $my_req_id;
