nginx 通过 location 路径前缀精准代理微服务到不同端口，需注意 proxy_pass 末尾斜杠控制路径重写、透传 host 和真实客户端 ip，并用 upstream 实现负载均衡与健康检查。
在 Nginx 中用 proxy_pass 代理不同端口的微服务，核心是根据请求路径（或域名、Header 等）精准匹配，并把流量转发到对应后端服务的 IP 和端口。关键不在“多个端口”本身，而在于如何区分请求、避免路径错乱、正确传递客户端信息。
按路径前缀区分微服务
这是最常用的方式。每个微服务暴露在本地不同端口（如用户服务在 8001，订单服务在 8002），Nginx 根据 location 块的路径前缀做路由：
- 确保
location使用精确匹配（=）或前缀匹配（^~），避免正则干扰性能 -
proxy_pass末尾是否带/决定路径重写行为：带/会剥离匹配的前缀；不带则原样转发 - 例如将
/user/下所有请求转给http://127.0.0.1:8001，需写成proxy_pass http://127.0.0.1:8001/;（注意末尾斜杠）
保持 Host 和真实客户端信息
微服务常依赖 Host 头做内部识别，也需知道真实客户端 IP：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 添加
proxy_set_header Host $host;或$http_host，保留原始 Host - 用
proxy_set_header X-Real-IP $remote_addr;和X-Forwarded-For透传 IP - 若后端是 Spring Cloud Gateway 或类似网关，通常还需
proxy_set_header X-Forwarded-Proto $scheme;
健康检查与负载均衡（多实例时）
单端口对应一个实例时可直连；若某微服务有多个端口实例（如 8001、8001 备机），应定义 upstream：
- 在
http块中定义upstream user-svc { server 127.0.0.1:8001; server 127.0.0.1:8001 backup; } - 在
location中使用proxy_pass http://user-svc; - Nginx 默认轮询，也可加
weight、max_fails、fail_timeout实现基础健康探测
避免常见路径重写错误
路径错位是代理失败的主因之一：
- 错误写法：
location /api/user { proxy_pass http://127.0.0.1:8001; }→ 请求/api/user/profile会转发为http://.../api/user/profile，后端可能不识别 - 正确写法：
location /api/user/ { proxy_pass http://127.0.0.1:8001/; }→/api/user/profile变成/profile转发 - 若后端必须接收带前缀的路径（如强制要求
/user/profile），可用rewrite显式转换，但优先推荐后端适配无前缀路径
