Nginx 的 if 指令不支持嵌套，强行嵌套会导致语法报错且仅最外层条件生效；应使用 set 变量组合、map 映射或 allow/deny 等原生命令替代。
Nginx 的 if 指令根本不支持嵌套，强行写嵌套结构不仅语法报错（如 unknown directive "if"），更会导致访问控制逻辑彻底失效——看似写了多层判断，实际只有最外层条件起作用，内层被忽略或触发未定义行为。
为什么嵌套 if 会失效
Nginx 的 if 是 rewrite 模块的指令，不是编程语言中的控制结构。它在配置解析阶段就被展开为一组重写规则，不构成作用域或执行栈。所谓“嵌套”只是文本上的缩进，Nginx 会按顺序逐条执行所有 if 块，彼此独立、无层级关系，也无短路机制。一旦多个 if 同时匹配，变量可能被反复覆盖，最终结果不可预测。
用 set + 变量组合替代嵌套判断
把多条件逻辑拆解为变量赋值链，用单一变量承载综合判断结果：
- 先定义一个初始状态变量，例如
set $allow_access "0"; - 用多个并列
if分别检查来源 IP、请求头、URL 参数等，只要任一条件满足，就设为"1"：if ($http_x_forwarded_for ~ "192\.168\.0\.2") { set $allow_access "1"; }if ($arg_token = "valid") { set $allow_access "1"; } - 最后统一拦截：
if ($allow_access = "0") { return 403; }
用 map 指令实现更安全的多条件映射
推荐在 http 块中使用 map，它在请求处理早期就完成变量计算，无执行阶段冲突，且天然支持多条件组合：
- 例如根据 IP 和请求方法共同授权：
map "$http_x_forwarded_for:$request_method" $access_granted {<br> default 0;<br> "192.168.0.2:POST" 1;<br> "10.0.0.5:GET" 1;<br>} - 在
location中直接引用：if ($access_granted = "0") { return 403; }
优先用原生命令替代 if 实现访问控制
很多常见场景根本不需要 if：
- 单纯限制 IP 访问：用
allow/deny，支持 CIDR 和文件列表，性能高且语义清晰 - 限制请求方法：用
limit_except，比if ($request_method !~ ...)更可靠 - 校验请求头存在性：用
map映射$http_x_api_key到布尔变量，再配合if或auth_request
真正需要条件判断时，宁可用多个扁平 if + 变量中转，也别尝试嵌套。map 是多数访问控制场景的首选解法，稳定、高效、易读。
