Nginx中实现多条件分支重写应优先采用location分层匹配+rewrite位置控制+变量组合判断，而非嵌套if；推荐用map做静态多路分支，复杂逻辑应交由auth_request或Lua处理，确保配置清晰、安全、可维护。
在 Nginx 中实现“多条件分支重写”，本质不是靠嵌套 if 或多个 rewrite 拼凑，而是靠 location 分层匹配 + rewrite 位置控制 + 变量组合判断 来达成清晰、可维护、低风险的效果。硬塞一堆 if 块不仅违反官方建议，还极易引发匹配混乱、循环或 500 错误。
优先用 location 划分主路径，再按需 rewrite
把不同业务路径提前隔离，比在 if 里反复判断更高效、更安全：
- /api/v1/ → 走 legacy 接口代理，内部路径改写用 break
- /api/v2/ → 直接 proxy_pass 到新服务，不重写
- /static/ → 静态资源，用 try_files + alias 处理，避免 rewrite
- 根路径 / → 根据 $args 或 $host 动态跳转，用 return + 状态码更稳妥
例如：
location ^~ /api/v1/ {
rewrite ^/api/v1/(.*)$ /legacy/$1 break;
proxy_pass http://backend_legacy;
}这里用 ^~ 确保前缀匹配优先，break 防止后续 location 再次介入，整个流程可控无歧义。
需要条件判断时，用 if + return/set，慎用 rewrite
if 不是不能用，但只适合做“守门员”：满足条件就终止（return）或设标记（set），再交给 location 或其他指令处理。
- 检查域名：
if ($host ~* ^(www\.)?old-site\.com$) { return 301 https://new-site.com$request_uri; } - 拦截非法参数：
if ($args ~* "phpinfo|exec=") { return 403; } - 设置变量供后续用：
if ($http_user_agent ~* "curl") { set $is_curl "1"; }，然后在 location 中结合try_files或proxy_set_header使用
关键原则：if 块里尽量不用 rewrite；要用，必须确保 replacement 是完整 URL（含协议）且 flag 是 redirect/permanent，否则行为不可控。
用 map 指令做轻量级多路分支（推荐）
map 是 Nginx 原生支持的高效变量映射机制，适合基于 host、uri、args 等做静态多选一逻辑，比 if 更简洁、更易读、更少副作用。
map $host $target_backend {
default "backend_default";
~^app\.dev$ "backend_dev";
~^api\.prod$ "backend_api";
www.example.com "backend_main";
}
<p>upstream backend_default { server 127.0.0.1:8001; }
upstream backend_dev { server 127.0.0.1:8002; }</p><h1>……</h1><p>server {
location / {
proxy_pass <a href="https://www.php.cn/link/cddf97a969951d5d4db2728c7894524b">https://www.php.cn/link/cddf97a969951d5d4db2728c7894524b</a>;
}
}它不执行重写，但能驱动 proxy_pass、root、甚至 rewrite 的 replacement 字段（如 rewrite ... /$target_path/$1 break;），实现真正的“分支路由”效果。
复杂逻辑拆到应用层或 Lua（进阶选择）
当规则涉及时间窗口、IP 地段、数据库查表、JWT 解析等动态决策时，Nginx 本身不是最佳载体：
- 简单鉴权/灰度：用
auth_request转发到内部 auth service - 高灵活路由：启用
nginx-lua模块，用 Lua 脚本写 if-else-elseif，调用 cosocket、redis、json 等，再 set $var 控制后续行为 - AB 测试/流量染色：用 OpenResty 的
balancer_by_lua*实现请求级动态 upstream 选择
这类方案把复杂性移出配置文件，提升可测试性和可维护性，也规避了 Nginx 配置 reload 的冷启动问题。
