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 内部调度路径上互斥，不是兼容性问题，而是架构层面禁止。
注意：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 少得多。
