nginx路径规范统一靠location+proxy_pass组合实现，upstream仅提供业务语义化的后端抽象；proxy_pass末尾斜杠决定路径是否剥离前缀，需严格匹配微服务根路径监听习惯。
在分布式微服务网关中，Nginx 的 upstream 本身不处理路径规范，真正统一路径规范的是 location 路由 + proxy_pass 配置组合，而 upstream 的作用是为这一组合提供稳定、可维护的后端抽象。关键不在 upstream 写什么，而在于它怎么被调用。
Upstream 命名与结构要体现业务语义，不暴露路径逻辑
每个微服务或功能域对应一个独立 upstream 块，名称带业务标识（如 user-svc、order-api、payment-lambda），不包含版本、环境或路径信息。这样后续切换 v2 接口、灰度流量、跨集群迁移时，只需改 upstream 内部节点，无需动 location 规则。
- ✅ 推荐：
upstream user-svc { server 10.0.1.5:8081; } - ❌ 避免：
upstream user-v1-prod { server ... }或把路径写进 upstream 名称里
路径剥离必须靠 proxy_pass 末尾斜杠控制
proxy_pass 后是否加 /，直接决定请求路径是否被剥离前缀。这是统一路径规范最实际的一环：
-
proxy_pass http://user-svc/;→ 请求/api/users/list到达后端变为/users/list（自动剥离/api） -
proxy_pass http://user-svc;→ 请求/api/users/list到达后端仍是/api/users/list（完整透传，易导致 404）
多数微服务默认监听根路径，所以 location 匹配带前缀（如/api/users/）时，proxy_pass 必须结尾加/，否则后端收不到预期路径。
路由层统一做前缀标准化，upstream 不参与重写
路径标准化（如强制小写、补全 trailing slash、移除冗余 /../）应在 location 或 server 块中用 rewrite 或 map 完成，而不是让 upstream 承担。例如：
- 统一去除
/api前缀：location /api/users/ { rewrite ^/api/(.*)$ /$1 break; proxy_pass http://user-svc/; } - 全局路径小写转换（需启用
ngx_http_map_module）：map $request_uri $lower_uri { ~^(?<pre class="brush:php;toolbar:false;" fix>[^?]*)(?<query>.*)$ ${prefix~}${query}; }</query>
多环境/多地域场景下，用 upstream 分组隔离，路径规则复用
不同地域或环境的同一服务（如 user-svc-china, user-svc-us）可定义不同 upstream，但共用同一套 location 路由配置。这样路径规范完全一致，只通过变量或 geo 指令动态选择 upstream：
geo $region {
default china;
192.168.0.0/16 us;
}
upstream user-svc {
server 10.0.1.5:8081; # china
}
upstream user-svc-us {
server 20.0.1.5:8081; # us
}
location /api/users/ {
set $backend "user-svc";
if ($region = "us") { set $backend "user-svc-us"; }
proxy_pass http://$backend/;
}
路径匹配、剥离、头设置等逻辑完全复用，避免因环境差异导致路径行为不一致。
不复杂但容易忽略
