proxy_pass末尾斜杠决定路径处理模式：带斜杠则替换location前缀，不带则原样拼接；正则匹配需显式指定目标路径；协议、端口、Host头等必须显式配置，否则易致404或重定向失败。
proxy_pass 在 Nginx 中不是简单地“转发 URL”，而是根据 location 匹配结果和 proxy_pass 指令写法，决定如何拼接后端地址。匹配逻辑直接影响路径是否被截断、参数是否保留、协议是否正确，稍有偏差就会导致 404 或接口调用失败。
location 匹配是 proxy_pass 的前提
请求先由 Nginx 根据 location 规则匹配路径，只有匹配成功的 location 块才会执行其中的 proxy_pass。匹配顺序遵循：
- 精确匹配（=）优先级最高
- 前缀匹配（如 location /api/）按最长前缀生效
- 正则匹配（~ 或 ~*）按配置文件中出现顺序，首个命中即停止
- 若无任何匹配，走默认的 / location
proxy_pass 地址末尾斜杠决定路径处理方式
这是最容易出错的关键点。proxy_pass 后的 URL 是否带结尾斜杠，直接控制请求路径的替换行为：
- proxy_pass http://backend;（无斜杠）→ 完整保留原始 URI 路径，例如 /api/v1/user → 转发为 http://backend/api/v1/user
- proxy_pass http://backend/;（有斜杠）→ 截掉 location 匹配部分，只转发剩余路径。例如 location /api/ { proxy_pass http://backend/; }，请求 /api/v1/user 就变成 http://backend/v1/user
注意：如果 location 使用正则表达式（如 location ~ ^/api/(.+)$），必须配合 proxy_pass 中的变量（如 http://backend/）才能精准传递子路径。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
协议与端口需显式指定，不能依赖默认值
proxy_pass 不会自动补全协议或端口。常见错误包括：
- 写成 proxy_pass backend;（缺少协议）→ Nginx 会报 invalid URL 错误
- 后端监听非标准端口（如 8080）但未在 proxy_pass 中写出 → 请求发往默认 80 端口导致超时
- HTTPS 后端必须写 https://backend:443，且需确保 Nginx 编译时启用了 ssl 模块
请求头与重定向响应需额外处理
proxy_pass 默认不改写 Host 和重定向 Location 头，这常导致后端返回 302 跳转时跳向内网地址。应补充：
- proxy_set_header Host $host;（传递原始 Host）
- proxy_set_header X-Real-IP $remote_addr;（透传真实客户端 IP）
- proxy_redirect off; 或 proxy_redirect http://backend/ /;（重写后端返回的跳转地址）
若后端返回的是绝对跳转地址（如 Location: http://192.168.1.10/login），必须用 proxy_redirect 显式重写，否则浏览器将跳向不可达地址。
