分号和空格是加权轮询配置的关键语法要素：分号缺失导致nginx启动失败，空格错位使weight参数被忽略而退化为普通轮询；需通过nginx -t校验、-t查看实际加载配置、error日志及流量统计验证。
加权轮询配置中，分号和空格不是“可有可无”的格式细节，而是决定配置能否生效甚至能否启动的关键语法要素。Nginx 解析 server 指令时非常严格：weight 参数必须紧贴在 server 地址之后，且整行必须以分号结尾；任何多余空格、换行或错位都会导致权重失效，甚至让 Nginx 启动失败。
分号缺失：直接报错，无法启动
server 行末尾漏掉分号，是典型语法错误：
- ✘ 错误写法：
server 192.168.1.10 weight=3（缺分号） - ✘ 错误写法：
server 192.168.1.10 weight=3 ;（分号前多空格，虽部分版本容忍，但不推荐） - ✔ 正确写法：
server 192.168.1.10 weight=3;（无多余空格，分号紧跟）
执行 nginx -t 会明确报错：directive "server" is not terminated by ";"，配置校验直接失败。
空格错位：权重被忽略，退化为普通轮询
weight 参数若与 server 地址之间插入了换行或制表符，Nginx 会完全忽略该参数：
- ✘ 错误写法：
server 192.168.1.10<br> weight=3;
（换行后缩进） - ✘ 错误写法：
server 192.168.1.10 weight=3;（中间两个以上空格） - ✔ 正确写法：
server 192.168.1.10 weight=3;（仅一个空格分隔）
此时 nginx -t 能通过，但实际运行中该 server 权重为默认值 1，整个 upstream 变成标准轮询，流量不会按预期比例分配。
快速验证权重是否真正加载
不能只看配置文件，要查运行态信息：
- 用
nginx -T | grep -A5 "upstream backend"查看 Nginx 实际加载的完整配置（-T 输出已展开的全部配置），确认 weight 是否出现在输出里 - 检查 error 日志：
tail -f /var/log/nginx/error.log，启动时若 weight 解析异常，通常会有 warning 提示 “invalid parameter” 或 “ignored” - 做 60 次连续请求（如
for i in {1..60}; do curl -s http://nginx/ | grep IP; done），统计各后端出现次数——若总权重为 6（如 3+2+1），理想分布应接近 30 / 20 / 10；偏差超过 ±5% 就需重新检查空格与分号
编辑器与自动化建议
人工肉眼排查容易遗漏，建议借助工具降低出错概率：
- 用 VS Code 或 Vim 打开配置文件时，开启“显示空白字符”（如 VS Code 的
editor.renderWhitespace: "all"），能直观看到多余空格和制表符 - 写完配置后，用
sed -n '/server.*weight=/p' /etc/nginx/conf.d/*.conf提取所有含 weight 的行，逐行核对结尾和空格 - CI/CD 流程中加入 shell 校验脚本，例如检查每行
server.*weight=.*[0-9];$是否匹配，不匹配则阻断发布
