uninitialized_variable_warn 是 OpenResty 特有指令，原生 Nginx 不支持；需确认 nginx -V 输出含 openresty 或 --add-module=../ngx_http_lua_module；仅限 http 块顶层配置，开启后 Lua 访问未初始化变量将记录 warn 日志。
在 Nginx 的 http 块中配置 uninitialized_variable_warn on; 时，Nginx 启动或重载会报错：“unknown directive ‘uninitialized_variable_warn’”。这是因为该指令并不存在于标准 Nginx 中——它属于 OpenResty 的扩展功能，原生 Nginx 不支持。
确认你用的是 OpenResty 而非原生 Nginx
该指令由 OpenResty 的 ngx_http_lua_module 提供，用于在 Lua 脚本中访问未初始化的 Nginx 变量时发出警告（避免静默返回空字符串导致逻辑错误）。如果你安装的是官方 Nginx（如 nginx.org 或系统包如 nginx-full），该指令必然不可用。
- 运行
nginx -V 2>&1 | grep -o 'openresty'，有输出说明是 OpenResty - 运行
nginx -V查看 configure arguments，含--add-module=../ngx_devel_kit和--add-module=../ngx_http_lua_module也表明是 OpenResty - 若确认是原生 Nginx，直接删除该行即可，无需替代方案（因无对应机制）
OpenResty 中正确启用 uninitialized_variable_warn
该指令必须出现在 http 块顶层（不能在 server 或 location 内），且需确保 Lua 模块已加载：
- 检查
nginx.conf的http块开头是否已有lua_package_path或init_by_lua_block等 Lua 相关配置（这是模块已启用的常见信号） - 确认没有拼写错误：必须是
uninitialized_variable_warn on;（注意下划线、大小写和分号） - 该指令默认为
off，开启后，Lua 中如ngx.var.nonexistent将触发 warn 级日志，而非静默返回空
替代方案：原生 Nginx 下规避未初始化变量问题
原生 Nginx 不提供此警告机制，但可通过以下方式降低风险：
- 在
map块中为可能为空的变量设置默认值，例如：map $arg_user $safe_user { default "anonymous"; "" "anonymous"; } - 使用
if+set显式初始化（注意if在 location 外受限，建议在 location 内使用） - 在日志格式中用
$arg_xxx时，配合log_format的escape=json或条件字段，减少空值干扰分析
验证是否生效（OpenResty 环境）
添加如下测试配置后重载：
location /test-warn {
content_by_lua_block {
ngx.say("var: [", ngx.var.nonexistent, "]")
}
}
访问 /test-warn，若 Nginx error log 中出现类似 2024/05/10 12:34:56 [warn] ... variable "nonexistent" is uninitialized，说明配置已生效。
