在 nginx 中调试变量最直接的方法是使用 `echo` 模块将变量的值输出到 http 响应正文中。通过配置 `location` 块并启用 `echo` 指令，可以直接查看变量在当前请求上下文中的实际内容，从而验证变量是否按预期赋值或修改。
如何开启 echo 模块并输出变量
要使用 `echo` 模块，首先需要确保 Nginx 编译时已包含该模块（通常作为动态模块加载）。在配置文件中，定位到需要调试的 `location` 块，使用 `echo` 指令包裹变量名。Nginx 会在处理请求时解析变量，并将结果直接写入响应体。这种方法适用于所有类型的变量，包括内置变量和自定义变量。
server {
listen 80;
server_name localhost;
location /debug {
# 假设有一个自定义变量 $my_var
set $my_var "test_value";
# 输出变量值
echo "Value of my_var: $my_var";
# 也可以输出内置变量
echo "Request URI: $uri";
echo "Remote Address: $remote_addr";
}
}
上述配置中，当访问 `/debug` 路径时，Nginx 会执行 `set` 指令设置 `$my_var`，然后 `echo` 指令将其与文本拼接后返回。客户端收到的响应将是：
Value of my_var: test_value
Request URI: /debug
Remote Address: 127.0.0.1
如何处理变量冲突和默认值
在调试过程中，经常遇到变量未定义或为空的情况。Nginx 中未定义的变量默认为空字符串。可以使用 `if` 指令结合 `echo` 来检查变量状态，或者使用 `echo_if` 模块（如果可用）进行条件输出。此外，注意变量作用域：`set` 指令在 `location` 或 `server` 块中定义的变量仅在该块及其子块中有效。
server {
listen 80;
server_name localhost;
location /check {
# 未设置的变量默认为空
echo "Undefined var: [$undefined_var]";
# 设置变量后再次检查
set $defined_var "hello";
echo "Defined var: [$defined_var]";
# 检查内置变量是否存在
if ($http_user_agent) {
echo "User Agent: $http_user_agent";
} else {
echo "No User Agent header";
}
}
}
此配置展示了如何区分已定义和未定义的变量。`$undefined_var` 输出为空括号 `[]`，而 `$defined_var` 输出为 `[hello]`。对于内置变量如 `$http_user_agent`，如果客户端未发送该头，则条件不成立，输出提示信息。这有助于排查因变量缺失导致的逻辑错误。
基于 set 指令设置变量后的具体输出问题
当使用 `set` 指令设置变量后，其值可能在后续指令中被覆盖或修改。例如，在 `rewrite` 或 `proxy_pass` 中，某些内置变量会被自动更新。调试时应关注变量在关键指令执行前后的变化。可以通过在多个位置插入 `echo` 输出来追踪变量生命周期。
