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 或统一前缀管理
