nginx 的 if 在 location 中不能可靠做路径分支，因其不重新匹配 uri，仅对已确定的变量求值，易引发重写循环或变量失效；应优先用多 location 块精确匹配、map 预定义路由变量，或仅在需路径改写时谨慎配合 rewrite 使用。
Nginx 的 if 指令在 location 块中不能直接用于路径匹配的逻辑分支，因为 if 在 location 内部的行为受限且易出错——Nginx 官方明确不推荐在 location 中嵌套 if 来做路径判断。
为什么 if 不能可靠地在 location 中做路径分支
if 在 location 块中仅能对变量（如 $args、$http_user_agent）求值，而不能重新匹配 URI 路径；URI 已在进入 location 时完成匹配，if ($uri ...) 或 if ($request_uri ...) 虽语法合法，但无法实现“根据子路径跳转不同后端”的典型分支需求，还可能引发重写循环、变量未更新等问题。
推荐替代方案：用多个 location 块精确匹配
利用 location 本身的多级匹配机制，比 if 更高效、更安全：
-
location ^~ /api/v1/：前缀匹配，优先于正则，适合 API 分组 -
location ~ ^/static/(css|js)/.*\.(css|js)$：正则匹配特定资源路径 -
location = /healthz：精确匹配，开销最小，适合探针 - 按顺序书写，Nginx 自动选择最优匹配块，无需手动逻辑判断
需要动态路径逻辑时：用 map + location 组合
若必须基于路径内容做条件路由（例如按路径前缀分发到不同 upstream），用 map 预先定义变量，再在 location 中引用：
map $uri $backend {
~^/service-a/ service_a_backend;
~^/service-b/ service_b_backend;
default default_backend;
}
然后在 server 块中：
location / {
proxy_pass http://$backend;
}
这样既保持配置清晰，又避免 if 的副作用。
极少数需 if 的场景：配合 rewrite 实现路径改写
仅当确实要修改请求路径本身（如统一补全 trailing slash 或重写旧路径），可谨慎使用 if + rewrite，但须注意：
- 必须加
break或last控制流程，避免重复执行 - 不要在
if中混用proxy_pass和rewrite - 示例：强制为目录路径补 /
if (-d $request_filename) { rewrite ^[^(.*)/]$ $1/ break; }
