proxy_pass路径末尾加斜杠表示Nginx自动剥离location前缀再拼接，不加则原样转发；带子路径时加斜杠可避免路径粘连，推荐使用。

proxy_pass 路径末尾加不加斜杠，本质是告诉 Nginx 怎么处理请求路径——是原样转发，还是先去掉 location 前缀再拼接。这个字符写错，后端就收不到正确路径，接口直接 404。

末尾不加斜杠：完整 URI 原样转发

当 proxy_pass 后面只有协议、地址和端口（如 http://127.0.0.1:8080），Nginx 不做任何路径截断，把客户端请求的整个路径（包括 location 匹配部分）直接拼过去。

• 配置示例：location /api { proxy_pass http://127.0.0.1:8080; }
• 客户端访问 /api/user → 后端收到 /api/user
• 适用场景：后端服务本身也以 /api 为上下文启动（比如 Tomcat 部署在 /api 应用下）
• 风险点：如果后端监听根路径，这种写法会让所有请求带 /api 前缀，大概率 404

末尾加斜杠：自动剥离 location 前缀

只要 proxy_pass 以 / 结尾（如 http://127.0.0.1:8080/），Nginx 就会把 location 匹配到的路径前缀整个移除，只把剩余路径追加到 proxy_pass 的 / 后面。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 配置示例：location /api/ { proxy_pass http://127.0.0.1:8080/; }
• 客户端访问 /api/user → 后端收到 /user
• 客户端访问 /api/v2/login → 后端收到 /v2/login
• 适用场景：前后端分离架构，后端是 Spring Boot、Express 等默认跑在根路径的服务
• 注意：location 写成 /api 或 /api/ 效果一致，只要 proxy_pass 末尾有 /，前缀就被替换

带子路径且不加斜杠：容易路径粘连

如果 proxy_pass 指向带路径但不以 / 结尾（如 http://127.0.0.1:8080/v1），Nginx 会把 location 前缀替换成 /v1，但中间**不加任何分隔符**，导致路径连在一起。

• 配置示例：location /api/ { proxy_pass http://127.0.0.1:8080/v1; }
• 客户端访问 /api/users → 后端收到 /v1users（不是 /v1/users！）
• 原因：/api/ 被替换成 /v1，后面紧接 users，中间没斜杠
• 建议：除非明确需要粘连效果，否则应避免；如需映射到 /v1，改用 http://127.0.0.1:8080/v1/

带子路径且加斜杠：安全重写，推荐使用

proxy_pass 指向带路径且以 / 结尾（如 http://127.0.0.1:8080/v1/），Nginx 仍执行前缀替换，但拼接更干净，语义更清晰。

• 配置示例：location /api/ { proxy_pass http://127.0.0.1:8080/v1/; }
• 客户端访问 /api/users → 后端收到 /v1/users
• 客户端访问 /api/v2/profile → 后端收到 /v1/v2/profile
• 优势：避免粘连，路径层级明确，适合版本化 API 或统一前缀管理