Nginx加权轮询因配置拼写错误（如weigth、max_conn、fail_time_out等）会被静默忽略，导致退化为默认轮询或失效；需结合nginx -T排查+运行时请求分布验证。
排查 Nginx 加权轮询（weighted round-robin）负载均衡因配置项拼写错误导致的降级，核心是快速定位语法/语义错误是否让 upstream 模块退化为默认行为（如简单轮询或直接失效），而非报错退出。
检查 upstream 块中是否误用了非法指令名
Nginx 不识别的指令会被静默忽略，但可能导致权重未生效。常见拼写错误包括：
- weight 写成 weigth、wight、weights（多加 s）——Nginx 忽略该行，服务器回退为 weight=1
- max_conns 写成 max_conn（少 s）或 max_connections（非标准）——被忽略，可能引发连接堆积却无告警
- fail_timeout 拼错为 fail_time_out 或 failtout——健康检查参数失效，故障节点不及时摘除
验证配置是否实际加载了权重逻辑
仅靠 nginx -t 无法发现语义错误（如拼错但语法合法的指令）。需结合运行时观测：
- 用
curl -s http://127.0.0.1:8080/nginx_status（需启用stub_status）或第三方模块如nginx-module-vts查看各 server 的请求计数比，确认是否符合 weight 比例（如 weight=3 和 weight=1 应接近 3:1） - 临时在每个后端加唯一响应头（如
add_header X-Backend-ID "A"），用for i in {1..100}; do curl -sI http://upstream/ | grep X-Backend-ID; done | sort | uniq -c统计分布 - 若比例严重偏离预期且无 error 日志，大概率是 weight 等关键参数未生效
注意 upstream 块外的干扰配置
某些看似无关的拼写错误会间接导致负载策略降级：
- 在
location中误写proxy_pass http://backend/;，但 upstream 名实际为backends（少 s）——Nginx 将其解析为域名，发起 DNS 请求失败后 fallback 到第一个 server，等效单点 -
ip_hash与weight同时存在时，Nginx 会忽略 weight（官方文档明确说明），若误以为“加了 weight 就有加权”，实则已退化为 IP 哈希 - 把
least_conn拼成 lest_conn，Nginx 忽略该指令，upstream 默认回退到 round-robin，失去最小连接数调度能力
用 nginx -T + grep 快速扫描可疑拼写
nginx -T 输出全部生效配置（含 include），配合关键词筛查可高效发现低级错误：
-
nginx -T 2>/dev/null | grep -A2 -B2 -i "weigth\|wight\|weights"—— 找疑似 weight 拼错行 -
nginx -T 2>/dev/null | grep -E "^\s*server.*[a-zA-Z]+:" | grep -v "weight=" | grep -v "backup"—— 列出所有未显式声明 weight 的 server 行（默认 weight=1，但可能本意是设更高值） - 对比正常环境的配置 diff，重点关注 upstream 块内每行开头是否为允许的关键字（server / keepalive / zone / hash / ip_hash / least_conn / random 等）
