Nginx负载均衡upstream哈希策略能否使用自定义请求头替代$request_uri

完全可以使用自定义请求头作为哈希计算依据，替代$request_uri实现Nginx upstream的哈希负载均衡策略。

Nginx的hash指令本身支持任意合法的Nginx变量作为哈希键，客户端发送的自定义请求头会被Nginx自动映射为$http_开头的变量，映射规则为：将请求头名称转为全小写，横杠替换为下划线。

以下是使用自定义请求头X-User-ID作为哈希键的配置示例：

upstream backend {
    hash $http_x_user_id consistent;
    server backend1.example.com;
    server backend2.example.com;
}

使用时需要注意以下几点：

• 处理请求头缺失场景：如果客户端未传递对应的自定义请求头，对应变量值为空，所有未传该头的请求都会被哈希到同一个上游节点，容易导致负载倾斜。建议配置组合变量做兜底，比如同时结合自定义头和客户端IP做哈希：hash "$http_x_user_id$remote_addr" consistent;
• 变量命名规则要正确：请求头名称必须按照映射规则转换后再加$http_前缀，比如请求头为X-Custom-Hash-Key，对应的变量是$http_x_custom_hash_key，命名错误会导致变量无法正常读取
• 一致性哈希的生效逻辑和使用$request_uri时完全一致，上游节点列表增减时只会重分配部分请求的映射关系，不会出现全量请求打散的情况

内容的提问来源于stack exchange，提问作者killjoy