proxy_pass末尾斜杠是路径转发逻辑开关：加斜杠则截断匹配前缀并拼接目标路径，不加则导致路径粘连404；正则匹配时必须显式指定uri；复杂改写需用rewrite+break。
proxy_pass 末尾斜杠不是格式偏好，而是路径转发逻辑的开关。加不加它，直接决定后端收到的是 /users 还是 /api/users。配错就 404，调试时却很难察觉。
location 和 proxy_pass 都带斜杠：最稳的默认写法
这是前后端分离项目的主流配置，适用于后端监听根路径（如 Express、Spring Boot 默认部署在 /）。
- 写法：
location /api/ { proxy_pass http://backend/; } - 效果：请求
/api/login→ 后端收到/login - 原理：Nginx 把匹配到的
/api/整段“去掉”，再把proxy_pass后的/拼上去，剩余路径直接接续 - 注意：统一用
/api/而非/api，避免匹配歧义（比如误中/apixxx）
proxy_pass 带自定义路径时，末尾斜杠不能省
当后端 API 实际跑在子路径（如 /v1）下，又不想让前端知道，就靠这个组合实现“透明重写”。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 正确写法：
location /service/ { proxy_pass http://backend/v1/; } - 效果：请求
/service/users→ 后端收到/v1/users - 错误写法：
proxy_pass http://backend/v1;（不带尾斜杠）→ 请求变成/v1users，路径粘连，必 404 - 关键点：末尾斜杠是分隔符，确保替换后路径结构干净
正则或精确匹配时，proxy_pass 必须显式带目标 URI
用 =、~、~* 等匹配方式时，Nginx 无法自动推断要截哪段路径，必须手动写出完整转发路径，否则配置加载失败。
- 错误示例：
location ~ ^/static/ { proxy_pass http://cdn; }→ Nginx 启动报错 - 正确写法：
location ~ ^/static/(.+)$ { proxy_pass http://cdn/$1; } - 健康检查特例：
location = /health { proxy_pass http://backend/health; }，精确匹配 + 显式路径，安全可靠 - 注意：捕获组
$1要和正则括号严格对应，否则转发为空
需要复杂路径改写？rewrite + break 是标准解法
当默认替换逻辑不够用（比如要把 /v2/api/users 变成 /api/v2/users），就得提前重写 URI。
- 配置示例：
location /v2/api/ { rewrite ^/v2/api/(.*)$ /api/v2/$1 break; proxy_pass http://backend/; } -
break表示重写后不再进入 location 匹配循环，防止重复处理 - 别用
last，容易触发重匹配导致循环转发 - rewrite 在 proxy_pass 之前执行，顺序不能颠倒
