nginx 的 ip_hash 通过哈希算法将客户端 ip 固定映射到特定后端服务器,当该后端下线时,nginx 默认会将请求重新分配给其他存活节点,导致会话丢失。要解决此问题,需结合 max_fails 和 fail_timeout 参数配置健康检查,并在 nginx 1.9.0+ 版本中启用 hash 指令的 consistent 选项(即一致性哈希),以减少后端变动时的哈希环扰动,从而降低会话迁移概率。

如何配置 ip_hash 的健康检查与故障转移
在传统的 ip_hash 配置中,Nginx 依赖 upstream 块中的 server 指令属性来判断后端状态。当某个后端服务器被标记为不可用(例如因 max_fails 达到阈值)时,Nginx 会将来自该 IP 的请求转发到其他可用的后端服务器上。这种机制虽然保证了服务可用性,但直接导致了原属于该 IP 的会话数据在新后端上不存在,从而引发会话丢失。因此,首要步骤是调整 max_fails 和 fail_timeout 以平衡故障检测的灵敏度与误判率。

http {
upstream backend {
# 使用 ip_hash 确保同一 IP 访问同一后端
ip_hash;
# 设置最大失败次数为 3,超时时间为 30 秒
# 如果 30 秒内连续失败 3 次,则标记该 server 为 down
server 192.168.1.101:8080 max_fails=3 fail_timeout=30s;
server 192.168.1.102:8080 max_fails=3 fail_timeout=30s;
server 192.168.1.103:8080 max_fails=3 fail_timeout=30s;
}
server {
listen 80;
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}上述配置中,max_fails=3 表示在 fail_timeout=30s 的时间窗口内,如果 Nginx 向某台后端服务器发起的请求有 3 次失败(如连接拒绝或超时),则该服务器将被暂时标记为不可用。此时,来自原本应路由到该服务器的 IP 的请求会被重新哈希到其他存活的后端。为了减少这种重定向带来的会话丢失,可以增大 fail_timeout 的值,或者使用更稳定的网络环境。此外,确保后端应用本身具备快速恢复能力也是关键。
如何使用一致性哈希减少会话迁移
从 Nginx 1.9.0 开始,ip_hash 的实现方式有所改进,支持基于一致性哈希算法。传统 ip_hash 使用简单的取模算法,当后端节点增减时,大量请求的路由目标会发生剧烈变化。而一致性哈希通过将后端节点和客户端 IP 映射到一个虚拟圆环上,当某个节点下线时,只有部分请求会迁移到相邻节点,从而显著减少了会话丢失的范围。要启用此功能,需在 upstream 块中使用 hash 指令并指定 consistent 关键字。

http {
upstream backend {
# 使用 hash 指令替代 ip_hash,并启用 consistent 模式
hash $remote_addr consistent;
server 192.168.1.101:8080;
server 192.168.1.102:8080;
server 192.168.1.103:8080;
}
server {
listen 80;
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}在此配置中,hash $remote_addr consistent; 取代了 ip_hash;。它使用 $remote_addr 作为哈希键,并采用一致性哈希算法。当后端服务器 192.168.1.101 下线时,只有那些哈希值落在 192.168.1.101 和下一个存活节点之间的请求才会被重新路由。大部分请求仍会留在原来的节点上,从而最大限度地保留了会话状态。需要注意的是,一致性哈希要求所有后端节点在逻辑上保持对称,因此在添加或删除节点时,应尽量平滑操作,以避免大规模的哈希重分布。
后端下线后具体哪些会话会丢失
当后端服务器因故障或维护而下线时,Nginx 会根据当前的负载均衡策略重新分配请求。对于使用 ip_hash 的场景,原本路由到该下线下游节点的 IP 地址的请求会被转移到其他存活节点。这意味着,这些 IP 对应的会话数据(通常存储在内存或本地文件中)在新的后端节点上不存在,从而导致会话丢失。具体来说,丢失的会话仅限于那些哈希值指向已下线节点的客户端 IP。如果使用了一致性哈希,则只有哈希环上受影响的少量 IP 会经历会话迁移,其余 IP 的会话保持不变。


















