启用 $request_id 并透传至前端可实现端到端链路追踪：Nginx 用 add_header 和 proxy_set_header 注入 X-Request-ID，React 初始化时读取并注入请求头，后端与日志统一记录该 ID，从而串联前端、Nginx、后端全链路日志。
用 Nginx 部署 React 应用时，前端请求缺乏唯一标识，导致日志难以关联、问题难定位。通过在 Nginx 中注入 $request_id 并透传到前端，可实现端到端链路追踪——这是排查首屏白屏、接口超时、跨服务调用等问题的关键一环。
启用并注入 $request_id 到响应头
Nginx 自带 $request_id 变量（需 1.4.0+），每次请求自动生成唯一 UUID。只需在 server 或 location 块中添加 header 即可透传：
location / {
# 启用 request_id（默认已开启，显式声明更清晰）
proxy_set_header X-Request-ID $request_id;
# 同时写入响应头，让前端 JS 能读取
add_header X-Request-ID $request_id always;
# 其他 React 静态资源配置（如 try_files）
try_files $uri $uri/ /index.html;
}注意：add_header ... always 确保即使返回 304 或错误状态也携带该 header；若用 proxy_pass 转发 API，则 proxy_set_header 让后端也能拿到 ID。
在 React 应用中读取并带上请求 ID
前端可通过 document.querySelector('meta[name="request-id"]') 或直接读响应头（需服务端允许 CORS）获取 ID。更通用的做法是：在应用初始化时读取 X-Request-ID，并挂载到全局或 Axios 实例中：
立即学习“前端免费学习笔记（深入）”；
- 使用
fetch时手动追加：headers: { 'X-Request-ID': requestId } - 使用 Axios：在
interceptors.request.use中自动注入 - 将 ID 写入 Sentry、LogRocket 等监控 SDK 的上下文，便于错误日志关联
配合日志与后端统一链路
确保后端（如 Node.js、Java Spring）也生成或接收 X-Request-ID，并在日志中打印。例如 Express 中可用 express-request-id 中间件；Spring Boot 可用 spring-cloud-starter-sleuth 或自定义 filter。Nginx 日志格式也应包含该字段：
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'req_id:"$request_id" upstream:"$upstream_http_x_request_id"';这样，从前端控制台报错、Nginx access log、后端业务日志，都能用同一个 ID 串联起来。
注意事项与常见问题
- React 是单页应用，页面跳转不触发新 Nginx 请求，所以首次 HTML 加载时的
X-Request-ID不适用于后续 Ajax 请求——必须由前端主动透传 - 若使用 Service Worker，需在
fetch事件中手动添加 header，否则会被拦截忽略 - 浏览器开发者工具 → Network → 查看任意请求的 Response Headers，确认
X-Request-ID存在且格式为 UUID - 避免在 index.html 中硬编码 ID，它必须随每次请求动态生成
