加权轮询必须写在upstream块的server行末尾，仅对默认轮询和ip_hash生效；weight不是独立指令，不支持小数、负数或字符串，且需配合max_fails和fail_timeout才具备容错能力。
加权轮询必须写在 upstream 块的 server 行里，且只对默认轮询和 ip_hash 生效；单独调权重不配健康检查，等于没做容错。
weight 参数只能放在 upstream 的 server 行末尾
很多人把 weight 写在 location 或 proxy_pass 旁边，Nginx 直接报错：unknown directive "weight"。它不是独立指令，也不是 location 级配置项。
-
upstream backend { server 10.0.0.1:8080 weight=3; }✅ 正确位置 -
upstream backend { server 10.0.0.1:8080; weight=3; }❌ 语法错误，weight不是单独语句 -
location / { proxy_pass http://backend; weight=2; }❌ Nginx 启动失败
weight 只在 round_robin 和 ip_hash 下起作用
least_conn、hash $request_uri、第三方 fair 模块都不认 weight。写了也白写，Nginx 不报错但不生效。
- 启用
ip_hash后，所有weight值被忽略——哈希绑定优先级高于权重 - 想用权重又需要会话保持？改用
hash $remote_addr consistent;（需 Nginx ≥ 1.7.2） -
least_conn不支持backup，也不读weight，别混搭
权重不是精确比例，得配 max_fails + fail_timeout 才算完整
设 weight=3 和 weight=1，小流量下可能连续 5 次都打到高权重点——这是正常行为。Nginx 不做计数器式调度，只按概率分布。
- 真实请求比例要在数百次以上才接近理论值（如 3:1）
- 若后端响应慢或超时，没配
max_fails和fail_timeout，Nginx 仍会持续发请求过去，最终堆积失败 - 正确写法：
server 10.0.0.1:8080 weight=3 max_fails=3 fail_timeout=30s;
reload 前必须 nginx -t，否则整站代理直接中断
改完 weight 最常踩的坑就是跳过语法检查。一旦 nginx -s reload 失败，worker 进程退出，所有请求返回 502。
- 权重写成小数（
weight=1.5）、负数（weight=-1）或字符串（weight=abc），nginx -t报错：invalid number of the "weight" parameter - 修改后建议用
curl -I http://your-vip/快速验证是否仍返回 200，再查后端access_log确认流量是否按预期分发 -
backup和down要配合weight使用：主力节点设高权，备用节点加backup标记，维护时用down临时摘除
真正容易被忽略的是：权重本身不解决故障转移，max_fails 和 fail_timeout 缺一不可；而 ip_hash 和 weight 共存会直接导致配置加载失败。
