nginx原生ip_hash不支持权重，混用会报“ip_hash cannot be used with weighted servers”并启动失败；应改用hash $remote_addr consistent配合weight实现带权ip粘性。

直接看报错信息就能确认是不是 ip_hash 和 weight 冲突：Nginx 启动或重载时若出现类似 “ip_hash cannot be used with weighted servers” 或 “ip_hash and weight cannot be used together” 的错误，就是这个冲突导致的。

快速定位配置问题

检查 upstream 块中是否同时存在以下两个元素：

• 启用了 ip_hash; 指令
• 任意 server 行里写了 weight=（哪怕只有一台写了，比如 server 10.0.0.1:8080 weight=2;）

只要两者共存，Nginx 就会拒绝加载配置，不会启动或重载失败。

为什么不能混用

ip_hash 的设计目标是强确定性：同一 IP 必须固定落到同一台后端，不考虑节点能力差异；而 weight 是为轮询类算法服务的，它依赖概率性调度来实现流量比例分配。这两种逻辑在 Nginx 内部调度路径上互斥，不是兼容性问题，而是架构层面禁止。

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

注意：ip_hash 对 IPv4 只取前三个八位组（如 192.168.1.x 全视为相同哈希输入），也不支持健康状态自动重映射——宕机节点恢复后，原 IP 请求仍可能打到已下线的地址，这点容易被误判为“哈希失效”，实则与 weight 无关。

验证真实客户端 IP 是否被污染

有时你以为没写 weight，但依然报错，可能是配置被其他文件 include 进来，或者你用了第三方模块引入了隐式权重。更常见的是：前端有 CDN 或代理，$remote_addr 实际是代理 IP，导致看似“没配 weight 却行为异常”。这时应检查：

• 是否启用了 real_ip_module
• 是否配置了 set_real_ip_from 和 real_ip_header X-Forwarded-For
• 日志中 $remote_addr 输出是否为真实用户 IP

替代方案推荐

如果业务确实需要“按 IP 绑定 + 支持权重”，不要强行保留 ip_hash，改用以下标准解法：

• 把 ip_hash; 替换为 hash $remote_addr consistent;
• 保留各 server 行的 weight= 参数
• 确保 $remote_addr 是真实 IP（否则换成 $http_x_forwarded_for 等可信头，需配合 real_ip 配置）

这样既维持 IP 级别粘性，又让权重生效，节点增减时请求漂移也比 ip_hash 少得多。