在 nginx 中,轮询负载均衡默认会将 url 中的查询参数(即问号及后面的内容)视为请求路径的一部分进行哈希计算或路由匹配。这意味着如果后端服务器状态发生变化,带有相同参数的请求可能会被分发到不同的后端节点,导致会话丢失或数据不一致。要解决这个问题,需要在 upstream 配置块中使用 hash 指令并指定 $request_uri 变量,或者使用 ip_hash 来保持客户端的粘性。

为什么轮询会导致带参 URL 路由不稳定?
轮询(Round Robin)是 Nginx 默认的负载均衡算法。它按顺序将请求分配给后端服务器,完全忽略请求的具体内容。当 URL 包含查询参数时,例如 /api/data?id=100,轮询算法不会识别 ?id=100 这部分内容对业务逻辑的重要性。如果后端集群中有服务器宕机或重启,后续的请求会被重新分配到新的服务器列表上。对于无状态应用这没问题,但对于依赖特定后端缓存或本地会话的应用,这种跳转会导致用户看到错误或空白页面。

upstream backend_pool {
# 默认就是 round-robin
server 192.168.1.10:80;
server 192.168.1.11:80;
}
server {
listen 80;
location /api/ {
proxy_pass http://backend_pool;
}
}
上述配置展示了最基础的轮询设置。当访问 /api/test?param=value 时,Nginx 仅仅根据当前负载情况选择 192.168.1.10 或 192.168.1.11。如果第一次请求到了 .10,第二次可能就到 .11。如果 .10 上缓存了 param=value 的结果,而 .11 上没有,用户就会经历性能下降或数据缺失。这就是为什么在处理带参 URL 时,简单的轮询往往不够用的原因。
如何使用 hash 实现基于完整 URI 的粘性负载均衡?
为了解决上述问题,可以使用 hash 指令。通过设置 hash $request_uri consistent;,Nginx 会对完整的请求 URI(包括路径和查询字符串)进行一致性哈希计算。这样,只要 URL 完全一致,请求就会被始终发送到同一台后端服务器,除非该服务器不可用。这种方法特别适合处理带有复杂查询参数的 API 请求,确保数据局部性。

upstream backend_pool {
# 使用一致性哈希,基于完整 URI
hash $request_uri consistent;
server 192.168.1.10:80;
server 192.168.1.11:80;
}
server {
listen 80;
location /api/ {
proxy_pass http://backend_pool;
}
}
在这个配置中,$request_uri 包含了 ?id=100 部分。当请求 /api/data?id=100 时,Nginx 计算该字符串的哈希值,并将其映射到固定的后端服务器。即使后端服务器数量发生变化,一致性哈希算法也能最小化键值的重新分布,从而减少因服务器变动导致的缓存失效。这是处理带参 URL 最推荐的方案之一。
当后端服务器宕机时,hash 策略如何处理重定向?
在使用 hash 策略时,如果目标后端服务器宕机,Nginx 会自动尝试将请求转发给其他可用的后端服务器。然而,这可能会导致原本应该命中特定服务器的请求被分发到另一台服务器,从而造成缓存未命中。为了验证这一行为,我们可以模拟一个后端宕机的场景。假设 192.168.1.10 宕机,所有针对 /api/data?id=100 的请求将被强制路由到 192.168.1.11。一旦 192.168.1.10 恢复,后续请求可能会再次回到 .10,具体取决于一致性哈希的槽位分配。
# 模拟测试:观察日志中的后端地址变化 # 正常情况: # GET /api/data?id=100 -> 192.168.1.10 # 192.168.1.10 宕机后: # GET /api/data?id=100 -> 192.168.1.11 (Failover) # 192.168.1.10 恢复后: # GET /api/data?id=100 -> 192.168.1.10 (Hash 重新计算)
这种故障转移机制确保了服务的高可用性,但开发者需要注意,故障期间的请求可能会产生额外的延迟,因为目标服务器需要重新生成数据或从数据库加载。因此,在生产环境中,建议配合健康检查模块(如 nginx_upstream_check_module)提前剔除故障节点,以减少切换带来的影响。


















