避免反向代理中因误用全局upstream导致路由失效，关键在于：upstream必须定义在http{}顶层，命名禁用下划线，proxy_pass末尾不可加斜杠，并为多站点分别定义专属upstream。
避免在反向代理架构中因误用全局 upstream 导致路由无法继承，关键在于理解 Nginx 配置的层级关系与作用域规则——upstream 是全局块指令，它本身不“继承”，但它的引用必须被正确、唯一地绑定到具体 server 和 location 中；所谓“路由无法继承”，实际是配置错位引发的 proxy_pass 失效、502 或请求错发。
确保 upstream 声明位置合法
upstream 必须定义在 http{} 块顶层，不能嵌套在 server{} 或 location{} 内。一旦写错位置，Nginx reload 会直接报错 unknown directive "upstream"，配置根本无法加载，更谈不上路由继承问题。
- ✅ 正确：放在
nginx.conf的http段开头，或通过include引入独立文件（如upstreams.conf） - ❌ 错误：
server { upstream api { ... } }—— 语法非法，且该块对其他 server 不可见
避免 upstream 名称触发 Host 头校验失败
当未显式设置 proxy_set_header Host $host 时，Nginx 默认将 upstream 名作为 Host 请求头值转发给后端。若名称含下划线（如 web_servers），Tomcat 8.5.23+、Spring Boot 2.3+ 等严格遵循 RFC 的服务会直接返回 400 Bad Request，导致请求中断，看似“路由失效”。
- 命名规范：只用小写字母、数字、连字符（
-），禁用下划线（_）、点（.）、大写字母 - 强制透传 Host：在每个
location中加proxy_set_header Host $host;，覆盖默认行为
保证 proxy_pass 精准指向且路径无歧义
proxy_pass 必须严格匹配已声明的 upstream 名，且末尾不能带斜杠；否则 Nginx 会报错或静默改变路径拼接逻辑，造成后端接收路径异常。
- ✅ 正确：
proxy_pass http://api_backend;（注意结尾无/） - ❌ 错误：
proxy_pass http://api_backend/;→ 报错upstream cannot have URI - 路径重写需求（如去掉
/api/）应使用rewrite或location匹配控制，而非依赖 proxy_pass 尾部斜杠“简化”
多站点共用 upstream 时明确隔离逻辑
多个 server 块可复用同一 upstream，但若需按域名分流到不同后端组，必须为每个站点定义专属 upstream 并在对应 server 中精准引用——不能靠“继承”或隐式 fallback。
- 例如：站点
a.com应proxy_pass http://backend_a;，站点b.com应proxy_pass http://backend_b; - 避免所有
server都指向同一个upstream却期望自动识别域名路由——Nginx 不做应用层内容路由，只做 TCP/IP 层转发
