nginx 的 if 块中不支持带路径的 proxy_pass，因其会忽略原始 uri 且不自动截断路径，易导致 404 或行为异常；应改用 rewrite + proxy_pass 组合或多个 location 匹配替代。
直接说结论：Nginx 的 if 块里不支持带路径的 proxy_pass，比如 proxy_pass http://backend/context 这种写法会报错或行为异常。这不是配置疏忽，而是 Nginx 官方明确限制的行为。
为什么 if 语句里不能用带路径的 proxy_pass
Nginx 在 if 上下文中对 proxy_pass 的处理是特殊的——它会忽略原始请求 URI，也不会自动做路径截断或替换。你写的路径（比如 /VirtualHostRoot）会被当作固定目标拼接，而不是动态重写逻辑的一部分。
- 官方说明明确指出：在
if块中使用proxy_pass时，“请求的 URL 不会被使用”，你必须自己构造完整目标地址 - 这意味着
location /api { if ($arg_debug) { proxy_pass http://dev/; } }是危险的：Nginx 不会帮你去掉/api，后端很可能收到/api前缀，导致 404 - 更严重的是，带变量的
proxy_pass（如proxy_pass http://$backend/）在if中也容易触发 DNS 缓存问题，且无法配合rewrite
替代方案：用 rewrite + proxy_pass 组合实现条件转发
真正可靠的做法，是把路径改写逻辑提前到 location 层级，再交给 proxy_pass 执行。这样既避开 if 限制，又保持路径可控。
- 先用
rewrite把 URI 改成目标格式，加break阻止后续重写 -
proxy_pass只写基础地址（如http://127.0.0.1:8080或http://backend/），不带动态路径 - 示例：把
/admin/xxx按条件转为/VirtualHostBase/http/example.com:80/admin/VirtualHostRoot/xxx
正确写法：
location /admin/ {
if ($host = "debug.example.com") {
rewrite ^/admin/(.*)$ /VirtualHostBase/http/example.com:80/admin/VirtualHostRoot/$1 break;
proxy_pass http://127.0.0.1:8080;
}
proxy_pass http://prod-backend/;
}
更推荐：用多个 location + 匹配修饰符替代 if
绝大多数条件转发需求，其实可以用更清晰、更稳定的 location 匹配组合完成，完全绕过 if 的坑。
- 用
^~强制前缀匹配优先级，避免被正则干扰 - 用
=处理精确路径（如健康检查/health） - 用
~*处理大小写不敏感的路径特征（如含debug参数的请求）
例如区分环境：
location ^~ /api/ {
proxy_pass http://prod-api/;
}
location ~* /api/debug/ {
proxy_pass http://dev-api/;
}
特别注意正则 location 中 proxy_pass 的写法
只要 location 用了 ~ 或 ~*，proxy_pass 后面就必须显式带 URI（哪怕只是 /），否则 Nginx 启动会失败。
- 错误写法：
location ~ \.js$ { proxy_pass http://cdn; }→ 启动报错 - 正确写法：
location ~ \.js$ { proxy_pass http://cdn/; }或proxy_pass http://cdn/$1;（配合 capture） - 如果需要保留原始路径名，用
proxy_pass http://cdn/$request_uri;，但要注意编码和安全性
