Nginx日志字段自定义提取客户端请求唯一ID-Nginx-PHP中文网

nginx 中获取客户端请求唯一 id 的关键是日志写入前注入并固定为变量：优先用 $http_x_request_id 直接引用请求头，缺失时通过 map 或 lua 生成默认/强唯一 id，并在 log_format 中使用对应变量。

nginx日志字段自定义提取客户端请求唯一id

要在 Nginx 日志中提取客户端请求的唯一 ID（如 X-Request-ID 或自动生成的 trace ID），关键不是“解析日志字段”，而是**在日志写入前就将该 ID 注入并固定为一个日志变量**。Nginx 本身不解析请求头再“提取”字段，而是通过 $http_x_request_id 这类内置变量直接引用请求头值，或用 map + random / lua 生成唯一 ID。

使用 $http_XXX 变量直接记录标准请求头

如果客户端（例如前端网关、OpenResty、Spring Cloud Gateway）已携带 X-Request-ID 或 X-Trace-ID，Nginx 可直接捕获：

变量名是小写的，且连字符转为下划线：X-Request-ID → $http_x_request_id
在 log_format 中添加该变量即可：
log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$http_x_request_id"';
若请求未带该头，对应位置会留空（可配合 map 设置默认值）

用 map 指令提供默认唯一 ID（无依赖 Lua）

当客户端不传 ID 时，可用 Nginx 原生命令生成轻量级唯一标识（如时间+进程+随机数组合）：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

在 http 块中定义：

map "" $req_id {<br>  default "$pid-$msec-$connection";<br>}

再用 map 优先取请求头，缺失时 fallback：

map $http_x_request_id $log_req_id {<br>  "" $req_id;<br>  default $http_x_request_id;<br>}

最后在 log_format 中使用 $log_req_id

用 Lua 脚本生成强唯一 ID（推荐用于分布式追踪）

若需符合 OpenTracing / W3C Trace Context 标准（如 16 字节 hex 或 32 位 UUID），建议集成 ngx_http_lua_module：

安装 OpenResty 或编译含 Lua 模块的 Nginx

在 http 块中定义变量：

lua_package_path "/path/to/lua-resty-random/lib/?.lua;;";<br>init_by_lua_block {<br>  require "resty.random"<br>}<br>set $trace_id "";<br>access_by_lua_block {<br>  if ngx.var.http_x_request_id then<br>    ngx.var.trace_id = ngx.var.http_x_request_id<br>  else<br>    local r = require "resty.random"<br>    ngx.var.trace_id = r:hex(16)<br>  end<br>}