Nginx中proxy_pass是否重写后端路径取决于其末尾是否有URI：带/则删除location前缀并拼接；不带/则原样转发；正则location中proxy_pass不可带URI，需用rewrite+break控制。

在 Nginx 中使用 proxy_pass 时，后端路径是否重写，取决于 proxy_pass 指令末尾是否有 URI（即路径部分），这是最核心的规则，也是最容易出错的地方。

proxy_pass 后带斜杠 /：触发路径替换

当 proxy_pass 的值以 / 结尾（即包含一个明确的 URI），Nginx 会删除 location 匹配到的前缀路径，再将剩余部分拼接到 proxy_pass 的 URI 后面。

例如：

location /api/ {
    proxy_pass https://backend.example.com/;
}

请求 /api/users → 后端收到 https://backend.example.com/users（/api/ 被去掉）

注意：proxy_pass https://backend.example.com/; 末尾的 / 是关键，它表示“替换为这个根路径”。

proxy_pass 后不带斜杠：不替换，原样转发

如果 proxy_pass 指令末尾没有 URI（即只到域名或 IP，无 /），Nginx 会把原始请求的完整 URI（包括 location 匹配部分）直接转发给后端。

例如：

location /api/ {
    proxy_pass https://backend.example.com;
}

请求 /api/users → 后端收到 https://backend.example.com/api/users（/api/ 保留）

这种写法等价于 proxy_pass https://backend.example.com$request_uri;，但更简洁安全。

用 rewrite 配合 proxy_pass 精确控制路径

当需要更灵活的路径改写（如去前缀、加前缀、大小写转换等），可在 proxy_pass 前用 rewrite 指令修改 $request_uri 或 $uri。

• 加前缀：rewrite ^/api/(.*)$ /v1/$1 break; → /api/users 变成 /v1/users
• 去多级前缀：rewrite ^/service/v2/(.*)$ /$1 break;
• 注意：rewrite 后加 break（终止当前 location 的 rewrite 处理），避免循环；不要用 last，否则会重新匹配 location，可能引发意外跳转

常见陷阱与建议

以下写法极易混淆，务必留意：

• proxy_pass http://127.0.0.1:8080/abc; → 请求 /api/x 会被重写为 /abc/x（/api 被整个替换）
• proxy_pass http://127.0.0.1:8080/abc（结尾无 /）→ 这是非法配置，Nginx 启动会报错：“invalid URL prefix”
• location 使用正则（如 ~ ^/api/）时，proxy_pass 不能带 URI（即不能有 / 结尾），否则报错；此时必须用 rewrite + break 控制路径
• 调试建议：开启 proxy_set_header X-Real-URI $request_uri;，在后端打印该 header，直观查看 Nginx 实际发了什么路径