Nginx无法直接在log_format中引用环境变量，但可通过map指令映射响应头、OpenResty的log_by_lua_block读取os.getenv()、proxy_set_header透传后端响应头或nginx -e注入变量等方式间接实现动态日志定制。
Nginx 本身不支持直接在 log_format 中引用环境变量，但可以通过启动前注入、模块扩展或反向代理透传等方式间接实现日志内容的动态定制。核心思路是：让 Nginx 能“看到”所需变量，再通过内置变量（如 $sent_http_x_custom_header、$arg_* 或自定义 map）将其写入日志。
使用 map 指令映射环境变量值
Nginx 启动时会读取系统环境变量，但不能直接在 log_format 中使用 $env_MY_VAR 这类语法。可行办法是借助 map 指令，在配置中预先将环境变量映射为一个 Nginx 变量：
- 在
http块中添加：map $sent_http_x_env_my_var $my_log_var {<br> default "";<br> "" $sent_http_x_env_my_var;<br>} - 更实用的做法是：由上游服务（如应用层）在响应头中设置
X-Env-My-Var，Nginx 用$sent_http_x_env_my_var获取它；或用 Lua 模块在请求阶段读取系统环境并赋值 - 若使用 OpenResty，可直接用
os.getenv("MY_VAR")在 log_by_lua* 阶段写入自定义字段
通过 proxy_set_header 透传运行时变量
当 Nginx 作为反向代理时，可让后端服务返回特定响应头，再将该头内容记录进 access log：
- 在 location 块中添加：
proxy_pass_request_headers on;（默认已开启） - 确保后端在响应中带上类似
X-App-Instance: prod-01的头 - 定义日志格式：
log_format custom '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$sent_http_x_app_instance"'; - 这样每条日志末尾就会出现部署实例名，便于追踪灰度流量或容器 ID
利用 nginx -e 参数注入启动变量（适用于容器化部署）
Docker 或 systemd 启动 Nginx 时，可通过 -e 传入变量，并在配置中用 env 指令声明，再配合 map 或 Lua 使用：
- 启动命令示例：
nginx -e "NGINX_ENV=staging" -c /etc/nginx/nginx.conf - 在 nginx.conf 的 http 块顶部加：
env NGINX_ENV; - 注意：仅声明的 env 才能在后续配置中被 map 或 Lua 访问，未声明则视为不可见
- 配合 map 使用时需注意——map 不支持直接引用 env，仍需借助 Lua 或 header 机制桥接
推荐方案：OpenResty + log_by_lua_block（最灵活）
如果允许引入 Lua，这是最可控的方式。无需重启即可动态读取环境变量并写入日志字段：
- 安装 OpenResty 后，在 location 或 server 块中添加：
log_by_lua_block {<br> local my_env = os.getenv("SERVICE_NAME") or "unknown"<br> ngx.var.log_service_name = my_env<br>} - 然后在 log_format 中使用：
$log_service_name - 该变量会在每次请求结束时计算，支持热更新、条件判断和拼接，适合多租户或微服务场景
