Cluster hash tag 同槽怎么配置或排查

Redis Cluster 中，多个键要一起执行多键命令、事务或 Lua 脚本，关键不是把键名写得相似，而是让它们计算出同一个 hash slot。最稳妥的做法是在相关键中复用非空的 hash tag，例如 user:{1001}:profile 与 user:{1001}:quota；然后用 CLUSTER KEYSLOT 分别验证，返回值一致才说明同槽。

先确定哪些键必须同槽

Redis Cluster 把键分到 16384 个 slot；没有 hash tag 时，计算输入是完整键名。只有确实要在一次多键操作中共同出现的键，才应该共享标签。比如订单读取可以把明细和状态写成 order:{9001}:items、order:{9001}:status，而首页推荐流 feed:home 不应为了“方便”绑到某个订单上。

设计标签时，把它当作业务边界而不是装饰字符。标签过于粗，会把大量请求集中到同一个 slot；标签过于细，又无法支持需要一起执行的多键命令。常见做法是按用户 ID、订单 ID 或会话 ID 选择稳定标识，并保持同一类键的模板一致。

用 hash tag 设计键名

Redis Cluster 的规则可以记成一句话：键中存在一对有效花括号时，只哈希第一处左花括号之后、紧邻的第一处右花括号之前的非空内容。于是 user:{1001}:profile 和 cache:{1001}:summary 都使用 1001，前缀和后缀不影响 slot。

# 中文说明：为同一用户生成可参加多键操作的键名
profile_key='user:{1001}:profile'
quota_key='user:{1001}:quota'

# 中文说明：两条键必须在同一个 Redis Cluster slot 才能一起执行
redis-cli -c -h 127.0.0.1 -p 6379 MGET "$profile_key" "$quota_key"

这里的 -c 只让客户端跟随集群重定向，不会替你修正错误的键设计。如果两条键没有共享有效标签，客户端仍可能收到跨 slot 错误。生产代码中应把标签拼接封装在一个函数或键工厂里，避免某个调用点漏掉花括号、改了 ID 格式或把大小写写成另一种形式。

用 CLUSTER KEYSLOT 验证实际 slot

排查时先脱离复杂业务命令，逐条查看键位。下面的命令不会读取键值，只根据键名计算 slot；把两次输出的整数进行对照即可。

# 中文说明：分别计算两条相关键的 slot，返回整数后比较是否相同
redis-cli -c -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:{1001}:profile'
redis-cli -c -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:{1001}:quota'

# 中文说明：发现不一致时，再检查实际传给客户端的完整键名
redis-cli -c -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:1001:profile'

只要前两条返回同一个 slot，hash tag 这一层通常是成立的；第三条没有有效花括号，会按完整键名计算，不能与前两条直接混用。注意命令参数必须是最终字符串，不能拿模板 user:{id}:profile 去验证实际的 1001。

按规则排查不一致

遇到 CROSSSLOT 或多键操作失败时，可以按这张清单缩小范围：

• 花括号是否为空：foo{}{bar} 中第一对花括号为空，因此按完整键名计算，不会使用 bar。
• 是否误解嵌套写法：foo{{bar}}zap 的有效内容是第一处左花括号和其右侧第一处右花括号之间的 {bar，不是直觉里的 bar。
• 标签是否逐字一致：1001、1001 、1001A 和 1001a 是不同字符串。
• 多键参数是否完整：检查最终传给 MGET、事务或脚本的每个键，不要只验证其中两个。

最后再看客户端层：某些框架会自动加前缀、租户标识或环境后缀。只要这些变化发生在花括号外，一般不影响同槽；如果它们改变了花括号内的标签，就必须重新计算。把“生成键名”和“执行多键命令”放在同一套测试用例里，比上线后从错误日志猜 slot 更可靠。

相关问题

同槽是不是代表键一定在同一台物理机器上？

在稳定的 Redis Cluster 配置下，一个 slot 由一个主节点负责，副本用于故障切换；发生迁移或故障转移时，服务节点可能变化，但键仍由 slot 映射决定。

hash tag 能不能解决所有跨 slot 操作？

不能。它只能让键位计算一致，不能替多键命令补齐缺失键，也不能替客户端处理错误的参数顺序和序列化。

为什么两个键看起来都带花括号却不同槽？

优先比较第一处有效花括号中的内容，再用 CLUSTER KEYSLOT 验证；空标签、大小写或隐藏空格都会造成不同结果。

是否应该给所有 Redis 键都加同一个 tag？

不应该。只给需要共同执行的键共享标签，并按业务标识分散标签，避免把无关流量集中到一个 slot。