nginx哈希键设置需兼顾业务语义、数据分布与后端能力，支持变量组合、一致性哈希及兜底处理以保障分流精准与缓存友好。
Hash 键值设置的灵活性，是 Nginx 负载均衡精准分流和缓存友好的关键。它不单是“选一个变量”，而是要结合业务语义、数据分布与后端能力做针对性设计。
支持任意字符串组合的哈希键
Nginx 的 hash 指令允许使用任意可解析的变量拼接作为键，比如：
-
hash $request_uri;—— 适合静态资源或 API 路径缓存一致性场景 -
hash $host$request_uri;—— 多租户环境下避免不同域名下路径冲突 -
hash $remote_addr$http_user_agent;—— 提升 IP 集中时的分散度（需注意隐私合规） -
hash $arg_uid;—— 用户 ID 显式传参时，保障同一用户始终落到同台服务（如会话无状态化改造）
动态键值需兼顾稳定性与区分度
键值越稳定，后端分布越固定；但若区分度过低（如只用 $remote_addr 前两段），易造成热点。优化建议：
- 避免空值或高频重复值：如
$arg_token若大量为缺失或默认值，会导致哈希倾斜 - 对长键做截断或哈希预处理：Nginx 不内置 MD5，但可通过 Lua 模块（如
set_by_lua_block）生成规范键 - 测试键分布：用日志记录
$upstream_addr和自定义键，抽样统计各后端请求占比是否接近理论均匀值
配合 consistent 参数提升节点伸缩鲁棒性
仅用 hash $key; 是普通哈希，节点增减会导致大面积重映射。启用一致性哈希可大幅降低抖动：
-
hash $request_uri consistent;—— 默认 160 个虚拟节点，已满足多数场景 - 高精度需求可显式指定：
hash $request_uri consistent=1000;，增强分布平滑性 - 注意：
consistent在开源版 Nginx 1.7.2+ 原生支持，无需第三方模块
慎用非常规变量，防止运行时异常
以下变量在某些请求中可能未定义或为空，直接用于 hash 可能导致不可预期分配：
-
$http_x_forwarded_for—— 多层代理下格式不一，建议优先用$remote_addr -
$arg_*类参数 —— 缺失时不参与哈希，等效于空字符串，易引发集中 - 解决方案：用
map预定义兜底值，例如
upstream backend { hash $hash_key consistent; ... }
