Nginx中proxy_pass路径映射取决于末尾斜杠：带/时截断location前缀后拼接，不带/时透传完整URI；可配合rewrite实现复杂重写；需注意正则location限制、重定向修正及请求头透传。
在 Nginx 中用 proxy_pass 实现带路径映射的反向代理，关键在于理解 URI 处理逻辑——尤其是末尾斜杠（/）是否出现，会直接决定路径如何被截断和拼接。
proxy_pass 后带斜杠：路径前缀被完全替换
当 proxy_pass 的 URL 以 / 结尾时，Nginx 会把 location 匹配到的路径前缀“去掉”，再将剩余部分拼接到后端地址之后。
例如：
location /api/ {
proxy_pass http://127.0.0.1:8080/;
}
- 请求
/api/users→ 转发为http://127.0.0.1:8080/users - 请求
/api/v2/orders?id=1→ 转发为http://127.0.0.1:8080/v2/orders?id=1
注意：/api/ 完全被剥离，不保留；后端服务需能响应 /users 这类路径。
proxy_pass 后不带斜杠：完整路径透传
如果 proxy_pass 指向一个不含结尾斜杠的地址（如 http://127.0.0.1:8080），Nginx 不做路径截断，而是把原始请求 URI 原样拼接过去。
例如：
location /api {
proxy_pass http://127.0.0.1:8080;
}
- 请求
/api/users→ 转发为http://127.0.0.1:8080/api/users - 请求
/api→ 转发为http://127.0.0.1:8080/api
这种写法适合后端服务本身监听 /api 子路径，或需要保留原始路径结构的场景。
用 rewrite 配合 proxy_pass 实现灵活路径重写
当需要更复杂的映射（比如把 /v1/user 改成 /user?version=v1），可先用 rewrite 修改 URI，再交由 proxy_pass 转发。
示例：将 /legacy/* 映射为 /new/*?from=legacy
location /legacy/ {
rewrite ^/legacy/(.*)$ /new/$1?from=legacy break;
proxy_pass http://127.0.0.1:3000;
}
- 请求
/legacy/profile→ URI 变为/new/profile?from=legacy→ 发往http://127.0.0.1:3000/new/profile?from=legacy -
break表示重写后不再匹配其他 rewrite 规则，直接进入 proxy_pass
注意事项与常见陷阱
- location 使用正则表达式（如
~ ^/api/）时，proxy_pass不能带变量，否则会报错；必须写死 URL 或用resolver配合变量 - 后端服务返回的重定向响应（302 Location）中含绝对路径时，客户端可能跳转到后端地址而非代理域名；应配置
proxy_redirect修正 - 若需传递原始 Host 头，加
proxy_set_header Host $host;；若要透传真实客户端 IP，加proxy_set_header X-Real-IP $remote_addr;和X-Forwarded-For
