多租户环境下 Nginx 权重分配的实施建议

多租户环境下Nginx权重必须按租户独立定义upstream块，禁止共用；weight仅在租户专属后端池内生效，需结合硬件能力、健康检查与路由策略配置，并通过日志和限流保障隔离性。

Nginx 中权重分配在多租户环境下不能简单复用单租户的“调高 weight 就多分流量”逻辑。核心原则是：每个租户必须拥有独立 upstream 块，权重只在其专属后端池内生效；跨租户之间不共享、不比较、不干扰。

为每个租户定义专属 upstream 块
共用 upstream 是多租户场景下最危险的配置错误。一旦多个租户指向同一个 upstream，它们的后端节点、健康状态、权重策略就完全耦合——某租户后端故障或压测，会直接拖垮其他租户。

• 正确做法：按租户名拆分 upstream，例如

  upstream tenant_a_backend {    server 10.0.1.10:8080 weight=3;    server 10.0.1.11:8080 weight=2;}upstream tenant_b_backend {    server 10.0.2.20:8080 weight=5;    server 10.0.2.21:8080 weight=1;}

• 所有 server 指令中的 weight= 必须写在 upstream 块内，且仅对 round_robin 或 ip_hash 算法有效
• 不要将 weight 写在 location 或 proxy_pass 附近，语法无效

权重值需匹配租户真实后端能力，而非全局统一标准
不同租户的后端规模、硬件配置、应用负载特征差异很大，同一套 weight 数值无法通用。

• 对 tenant-a：两台 16C32G 机器，响应稳定在 80ms → 可设 weight=5 和 weight=3
• 对 tenant-b：一台 4C8G + 一台老旧虚拟机，P95 RT 差 3 倍 → 更适合 weight=2 和 weight=1，甚至启用 max_fails=1 fail_timeout=10s 加速故障剔除
• 权重不是性能承诺，而是调度倾向。若某节点 RT 骤升，应优先检查其自身瓶颈，而非盲目调低 weight

避免与租户隔离机制冲突
权重必须和租户路由策略协同，否则会破坏隔离边界。

• 若使用 ip_hash 实现租户内会话粘性，weight 仅在节点被剔除后参与 fallback 调度，日常不生效
• 绝对不可在同一个 upstream 内混用 ip_hash 和 weight：ip_hash 会忽略 weight，导致预期外的流量倾斜
• 若租户通过 X-Tenant-ID 头识别（非子域名），需确保 map 分流后绑定到对应 upstream，且该 upstream 内部才设置 weight

配合运维可观测性落地
权重调优不是一次性动作，而需闭环验证。

• 在 log_format 中加入 $upstream_addr 和 $upstream_response_time，确认实际打到哪台后端、耗时是否合理
• 使用 limit_req zone=tenant_a burst=30 等租户级限流，防止某租户突发流量挤占其他租户资源
• weight=0 可用于临时摘除某租户的某台后端，但注意它仍接受健康检查；如需彻底隔离，改用 down

不复杂但容易忽略