排查nginx日志为空需确认变量拼写正确、作用域匹配且已定义：$variable拼错或未定义不报错但留空；须核对官方文档、检查上下文可用性、用debug日志和响应头验证。
排查 Nginx 配置中变量拼写错误导致日志为空，核心是确认 $variable 是否被正确解析 —— 拼错、作用域不对或未定义的变量在日志中会直接留空，且 Nginx 不报错，极易被忽略。
检查变量是否真实存在且拼写完全一致
Nginx 内置变量（如 $remote_addr、$request_time）区分大小写，且不能多字、少字或加下划线。例如写成 $remote_addrress 或 $request_time_ 都不会报错，但日志对应字段为空。
- 对照官方文档核对变量名：Nginx 变量索引页
- 常用易错变量举例：
$host（不是$hostname）、$request_uri（不是$request_url）、$status（不是$http_status） - 用
nginx -t无法发现拼写错误，它只校验语法结构，不校验变量语义
确认变量在当前作用域可用
某些变量仅在特定上下文生效。例如 $arg_xxx 在 location 块中可用，但在 http 块的 log_format 中直接使用可能无值；$upstream_http_xxx 必须在有 upstream 代理行为后才存在。
- 把待查变量临时挪到最外层
http块的log_format中，搭配一个简单location / { return 200 "ok"; }测试，排除 location 或 rewrite 影响 - 若依赖 proxy_pass，需确保请求实际经过 upstream，否则
$upstream_*类变量为空 - 自定义
map变量需确认map块已加载，且 key 匹配逻辑无遗漏（包括空值、默认值）
用调试日志定位具体哪一项为空
在 log_format 中为每个变量添加固定分隔符和标识，方便肉眼识别空字段：
log_format debug '$time_local | $remote_addr | "$request" | status:$status | rt:$request_time | ua:$http_user_agent | arg_x:$arg_x';
然后访问并查看 access log，逐项比对：如果只有某一项持续为空（比如 ua: 后直接跟空格），就锁定该变量问题。
- 启用
error_log /path/to/error.log debug;（需编译时含 debug 模块），可看到变量求值过程，但输出较冗长，适合深度排查 - 用
curl -H "User-Agent: test" http://localhost/主动控制输入，验证$http_user_agent是否正常捕获
验证变量是否被覆盖或重写
变量可能被 set、rewrite 或 proxy_set_header 覆盖，尤其注意 set $foo "" 或 set $foo $not_exist 会导致 $foo 为空字符串。
- 搜索配置中所有对该变量的
set、map、if块，确认赋值逻辑是否触发 - 用
echo模块（需第三方模块）或返回头方式临时输出变量值：add_header X-Debug-Var "$arg_token";，浏览器看响应头 - 避免在
if中 set 变量用于 log_format —— if 块内变量作用域受限，常导致日志中为空
