Nginx 权重配置优化业务接口的加权访问调度

Nginx权重必须写在upstream的server行后且为正整数，仅在加权轮询下生效；需结合健康检查、按路径/map分流及OpenResty动态干预，才能根据接口特征与后端能力合理分配流量。

要让 Nginx 根据业务接口特点合理分配流量，核心是把“权重”用对地方——它不是简单调个数字就能生效，而需匹配调度算法、请求特征和后端真实能力。

权重必须写在 upstream 的 server 行里

weight 参数只在 upstream 块中有效，且必须紧跟 server 地址之后：

• ✅ 正确写法：server 192.168.1.10:8080 weight=4;
• ❌ 错误写法：server 192.168.1.10:8080; weight=4;（weight 不是独立指令）
• ❌ 错误写法：location /api { proxy_pass http://backend; weight=2; }（语法报错）

权重默认为 1，只支持正整数；设为 0 表示该节点不参与轮询，但仍接受健康检查探测。

加权轮询适合异构后端，但比例是概率性的

比如三台服务器配置为：

• server 10.0.1.10:8080 weight=3;
• server 10.0.1.11:8080 weight=2;
• server 10.0.1.12:8080 weight=1;

理论请求占比约为 50% / 33.3% / 16.7%，但这不是精确计数结果。小流量下可能出现连续打到同一高权重点的情况，属于正常行为。真实分布需在数百次以上请求中观察才趋近理论值。

注意：weight 只对 round_robin（默认）和 ip_hash 生效；若启用 ip_hash，weight 仅用于故障剔除后的备用选择，不影响哈希绑定逻辑。

按接口路径或请求头做差异化分流

如果不同业务接口对资源消耗差异大（如 /report 耗 CPU，/status 轻量），可结合 map 指令实现静态特征路由：

• 用 map 提取 URI 或自定义 Header（如 X-Service-Type）映射到变量 $backend_group
• 为每类业务单独定义 upstream，各自设置合理权重
• 在 location 中用 proxy_pass http://$backend_group; 动态转发

例如将报表类请求全部导向高配集群，状态类请求走低配集群，避免互相干扰。

真正“按需”需 OpenResty + Lua 动态干预

纯 Nginx 无法实时感知后端 CPU、延迟或错误率变化。要实现动态加权调度，得借助 OpenResty：

• 用 balancer_by_lua_block 在每次请求时读取共享字典中的实时指标（如 avg_rt、error_rate）
• 按公式计算临时权重，比如：权重 ∝ 1 / (avg_rt × error_rate + 1)
• 调用 balancer.set_current_peer() 指定目标节点
• 配合外部监控系统（如 Prometheus Exporter）定时上报指标，维持字典更新

这种方式灵活但有开发与运维成本，适合对 SLA 要求高、后端负载波动大的核心业务。