nginx的weight参数定义后端服务器相对处理份额,非百分比;通过平滑加权轮询实现长期流量趋近设定比例,所有权重自动归一化(如5:3:2即50%:30%:20%),未声明默认为1,weight=0临时下线且不触发健康检查。

Nginx 的 weight 参数不是设置百分比,而是定义后端服务器之间的相对处理份额。它在默认的轮询(round-robin)策略下生效,通过平滑加权轮询算法,让流量长期趋近设定的比例,而不是每秒精确按比例分发。
权重怎么算出来的?
所有 weight 值会被自动归一化。比如配置了 weight=5、weight=3、weight=2,总和是 10,那么实际分配比例就是 50% : 30% : 20%。但若写成 weight=10、weight=6、weight=4,效果完全一样——Nginx 只看相对大小,不看绝对数值。
- 未声明 weight 的 server,默认值为 1
- weight=0 表示该节点临时下线,不参与请求分发,也不触发健康检查
- weight 值没有硬性上限,但建议控制在 1–100 之间,便于团队协作和后期维护
权重只在健康时起作用
weight 不是永久绑定的“流量锁”。一旦某台 server 因 max_fails 触发失败计数、被标记为不可用,它的 weight 就暂停生效;等 fail_timeout 时间过后,Nginx 尝试恢复探测,若恢复成功,weight 才重新参与调度。
- 故障期间,剩余健康节点会按各自 weight 重新归一化分担流量
- 例如原三台:A(weight=5)、B(weight=3)、C(weight=2),若 C 下线,则 A 和 B 按 5:3(即约 62.5% : 37.5%)分担全部流量
- 因此 weight 和
fail_timeout、max_fails是联动关系,不能单独调优
常见误区与实操提醒
weight 不代表实时连接数控制,也不感知响应延迟或 CPU 使用率。它只是静态配置的概率倾向,适用于服务器硬件能力差异较稳定的情况。
- 不要和
ip_hash同时使用——两者调度逻辑冲突,weight 会被忽略 - 低并发或短连接场景下,统计到的流量比例可能明显偏离理论值,需在持续中高流量下验证
- 验证方式推荐:开启
log_format记录$upstream_addr,再用日志聚合工具统计各地址出现频次 - 如需动态调整权重(比如根据 CPU 或 QPS 自动升降),需引入 Lua 模块或外部控制面,原生 Nginx 不支持运行时修改











