nginx的proxy_pass通过尾部斜杠控制路径截断：末尾带/则移除location前缀再拼接，不带/则完整转发原始uri；灵活重写需配合rewrite break指令，proxy_redirect用于修正后端返回的重定向头。
Nginx 的 proxy_pass 本身不直接“重写路径”，但配合 location 匹配规则和尾部斜杠（/）的有无，可以实现常见的路径前缀替换效果。关键在于理解 Nginx 如何处理请求 URI 与 proxy_pass 目标地址的拼接逻辑。
核心规则：尾部斜杠决定是否截断前缀
这是最常被忽略也最关键的点：
- 当
location使用前缀匹配（如location /api/ { ... }），且proxy_pass末尾带/（如proxy_pass http://backend/;），Nginx 会自动移除 location 匹配到的前缀部分，再拼接到后端地址后。 - 当
proxy_pass末尾不带/（如proxy_pass http://backend;），Nginx 会将原始请求 URI 完整拼接到后端地址后，不做截断。
✅ 正确示例（推荐）：
location /api/ {
proxy_pass http://127.0.0.1:8080/; # 注意末尾的 /
}
→ 请求 /api/users → 后端收到 GET /users
❌ 错误示例（易踩坑）：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location /api/ {
proxy_pass http://127.0.0.1:8080; # 缺少末尾 /
}
→ 请求 /api/users → 后端收到 GET /api/users（多了一层前缀）
需要更灵活重写？搭配 rewrite 指令
当简单前缀截断不够用（比如要删除中间段、替换关键词、加固定前缀等），可在 proxy_pass 前用 rewrite 显式修改 $uri：
- 使用
rewrite ... break;在当前上下文中重写 URI，不触发新 location 匹配（适合内部转发） - 使用
rewrite ... last;触发新一轮 location 匹配（慎用，可能循环）
示例：把 /v1/api/xxx 改成 /api/xxx 再代理
location /v1/api/ {
rewrite ^/v1(/api/.*)$ $1 break;
proxy_pass http://backend/;
}
→ /v1/api/users → 重写为 /api/users → 代理到后端 /users
注意 proxy_redirect 和后端返回的重定向头
如果后端返回 302 重定向，其 Location 响应头里的地址通常是内部路径（如 http://localhost:8080/login）。客户端无法直接访问，需用 proxy_redirect 重写该头：
-
proxy_redirect http://localhost:8080/ /;→ 把响应头中以http://localhost:8080/开头的重定向地址，替换成相对路径/ -
proxy_redirect default;→ 自动根据proxy_pass和server_name推导常见替换（多数情况够用）
其他实用细节
-
proxy_set_header Host $host;或$http_host：确保后端收到正确的 Host 头，尤其涉及虚拟主机或证书验证时 - 避免
location ~ \.php$这类正则匹配与proxy_pass混用——正则 location 不支持尾部斜杠截断逻辑，必须用rewrite + break显式控制 - 调试技巧：在后端加日志打印
request.url或req.originalUrl，确认实际收到的路径
