Nginx if语句中rewrite与proxy_pass配置失效问题求助

API 探路者

2026-6-15

Nginx代理转发配置修复方案

问题分析

你的配置失效核心原因是：if块内使用rewrite ... break后，proxy_pass未正确继承重写后的URI。Nginx中if块内的proxy_pass若不带具体URI，会默认使用原始请求的request_uri，导致重写的/pestiot前缀被忽略。

可行修复配置

方案1：直接在proxy_pass中拼接前缀（最简）

location ~ ^/api {
    if ($arg_ProCode = 420000) {
        # 直接将前缀拼接到proxy_pass的URI部分
        proxy_pass https://targetURL/pestiot$request_uri;
        break;
    }
    # 其他ProCode参数的请求转发（按需保留）
    proxy_pass https://targetURL;
}

优点：无需rewrite，直接通过$request_uri传递完整原始路径+参数，拼接/pestiot前缀后转发
注意：$arg_ProCode直接获取URL参数，比匹配request_uri更精准，避免参数位置变化导致匹配失败

方案2：用rewrite+last让Nginx重新匹配（更符合Nginx阶段处理逻辑）

location ~ ^/api {
    if ($arg_ProCode = 420000) {
        # 重写路径并使用last让Nginx进入新的location匹配
        rewrite ^/api(.*)$ /pestiot/api$1 last;
    }
    proxy_pass https://targetURL;
}

# 新增location匹配重写后的路径，确保转发正确
location ~ ^/pestiot/api {
    proxy_pass https://targetURL;
}

原理：last标记会终止当前rewrite阶段，让Nginx重新匹配重写后的URI，此时proxy_pass会使用重写后的完整路径

方案3：用map指令避免if（Nginx最佳实践）

# 提前根据ProCode参数映射前缀
map $arg_ProCode $proxy_prefix {
    420000  /pestiot;
    default ""; # 其他参数无前缀
}

location ~ ^/api {
    proxy_pass https://targetURL$proxy_prefix$request_uri;
}