如何通过 location 块的 rewrite 配合 if 判断实现复杂的条件转发-Nginx-PHP中文网

Nginx中不可在location内的if块中使用proxy_pass等指令，因其为伪指令且作用域受限；应优先用map提前生成变量，再在location中安全调用proxy_pass或rewrite，仅允许if内使用rewrite、set、return、break等安全指令。

如何通过 location 块的 rewrite 配合 if 判断实现复杂的条件转发

在 Nginx 中，location 块内的 rewrite 配合 if 实现“复杂条件转发”需格外谨慎——因为 if 在 location 中行为受限，且嵌套逻辑易出错。真正可靠的方式是：**优先用 map 提前构造变量，再结合 rewrite 或 proxy_pass 实现条件路由；仅在必要时（如简单请求参数/路径判断）谨慎使用 if + rewrite，并严格避免在 if 中使用 proxy_pass、root 等指令。**

为什么不能在 if 里直接写 proxy_pass？

Nginx 官方明确说明：if 是伪指令，其作用域内不支持 proxy_pass、root、alias 等大多数配置指令。若强行写入，Nginx 可能静默忽略、报错，或产生不符合预期的继承行为（例如 fallback 到外层 location 的 proxy_pass）。

错误示例（不生效）：

location /api/ {
    if ($arg_version = "v2") {
        proxy_pass http://backend-v2;  # ❌ 会被忽略！
    }
    proxy_pass http://backend-v1;
}

安全可行的条件转发组合方案

核心思路：把“判断逻辑”提前到 server 或 http 全局块，用 map 生成可信赖的变量，再在 location 中干净地使用该变量做 rewrite 或 proxy_pass。

步骤 1：用 map 构建目标上游变量
例如根据 URL 参数、请求头、路径前缀动态选后端：

map $arg_version $upstream_backend {
    "v2"     "http://backend-v2";
    "v3"     "http://backend-v3";
    default  "http://backend-v1";
}
<p>map $http_user_agent $is_mobile {
~*android|iphone  "1";
default           "0";
}</p>

步骤 2：在 location 中基于变量 rewrite 或 proxy_pass
此时变量已确定，无执行时序风险：

location /api/ {
    # 条件重写路径（如 /api/v2/users → /users）
    rewrite ^/api/v2/(.*)$ /$1 break;
<pre class="brush:php;toolbar:false;"># 条件代理（使用 map 生成的变量）
proxy_pass $upstream_backend;

# 或结合 if 做轻量判断（仅限 rewrite、set、return 等安全指令）
if ($is_mobile = "1") {
    rewrite ^/(.*)$ /mobile/$1 break;
}

}

if + rewrite 的适用边界（仅限这些场景）

当必须用 if 时，只允许它内部出现以下指令： rewrite、set、return、break。典型安全用法：

根据参数重写路径并终止匹配（break）：

location /old/ {
    if ($arg_redirect = "new") {
        rewrite ^/old/(.*)$ /new/$1 break;
    }
}

拦截非法请求并返回 403：

location /admin/ {
    if ($remote_addr !~ "(192\.168\.1\.|10\.0\.0\.)") {
        return 403;
    }
}

设置变量供后续 rewrite 使用（注意：set 不支持嵌套 if）：

set $target_path "";
if ($arg_type = "pdf") {
    set $target_path "/docs/pdf/";
}
if ($arg_type = "img") {
    set $target_path "/assets/images/";
}
rewrite ^/file/(.*)$ $target_path$1 break;

绕过 if 的更优雅替代方案

多数“复杂条件”其实可通过更健壮的方式表达：

多 location 分流：利用前缀匹配、正则 location 的优先级规则，天然实现条件分发
try_files + 内部重定向：配合命名 location 实现逻辑跳转
lua-nginx-module（OpenResty）：需要高度动态逻辑时，用 Lua 编写判断，比 if + rewrite 更清晰可控

例如用正则 location 区分版本：

location ~ ^/api/v2/ {
    proxy_pass http://backend-v2;
    rewrite ^/api/v2/(.*)$ /$1 break;
}
location ~ ^/api/v3/ {
    proxy_pass http://backend-v3;
    rewrite ^/api/v3/(.*)$ /$1 break;
}
location /api/ {
    proxy_pass http://backend-v1;
}