Redis CLUSTER KEYSLOT 怎样确认带标签键的槽位

我在设计 Redis Cluster 的多 key 读写时，最容易先看 key 前缀，后来发现这并不能说明两个 key 一定同槽。真正应该交给 Redis 判断的是 CLUSTER KEYSLOT：它返回目标 key 的 hash slot；如果 key 中存在有效的非空花括号标签，Redis 只对第一组标签内容计算槽位。

官方地址：https://redis.io/docs/latest/commands/cluster-keyslot/

确认带标签键的槽位，可以记成三步：先确定花括号里是否是有效标签，再分别执行 CLUSTER KEYSLOT，最后比较返回的整数。数字相同表示计算结果同槽，但不代表标签设计没有热点风险。

• 命令结果是 hash slot 编号，不是主节点地址。
• 有效标签是第一组非空 {} 中的内容。
• 相同标签适合确实需要同槽的 key，不能把全局数据都塞进一个标签。

先把槽位、标签和节点归属分开

Redis Cluster 的 key 空间划分为 16384 个 hash slot，主节点各自负责其中一部分。CLUSTER KEYSLOT key 返回的是算法计算出的槽位整数；槽位之后由集群拓扑映射到某个节点，所以命令输出本身不是节点地址，也不会告诉你当前重分片状态。

如果 key 没有有效标签，计算输入就是完整 key。若有第一组非空花括号，计算输入则是花括号内部的字节。例如 foo{hash_tag} 与 bar{hash_tag} 的前后缀不同，但标签相同，因此会得到相同槽位。这正是把同一业务实体的多个 key 放在一起的基础。

带标签 key 怎样写才不会失去语义

我通常把实体标识放进花括号，把用途放在标签外。这样读 key 时还能看出它表示资料、配额还是会话，同时又能让确实需要协同的 key 使用同一标签：

# 同一用户的两个相关 key 共享 user:1001 这个标签
user:{1001}:profile
user:{1001}:quota

# 不同用户使用不同标签，避免无关数据全部绑定到一槽
user:{1001}:profile
user:{1002}:profile

# 只有需要同槽的 key 才共用标签；单 key 操作不必强行加标签

花括号不是“看到就生效”。Redis Cluster 规范要求：必须找到第一处 {，右侧存在 }，并且两者之间至少有一个字符。foo{}{bar} 的第一对花括号为空，因此按完整 key 计算；foo{bar}{zap} 只取第一组有效或无效边界前的内容规则，不能凭肉眼把后面的标签当成计算输入。

用 CLUSTER KEYSLOT 直接对比结果

设计完成后不要手算 CRC16，也不要因为前缀相同就默认同槽。分别查询需要协同的 key，再把输出整数放在一起比较：

# 分别查询同一用户的两个 key，输出数字相同才表示同槽
redis-cli -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:{1001}:profile'
redis-cli -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:{1001}:quota'

# 再查另一个用户，用于确认标签确实随实体变化
redis-cli -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT 'user:{1002}:profile'

核对重点是第一、第二条是否返回同一个槽位，以及第三条是否因标签不同而出现另一个结果。Redis 官方把这个命令定位为调试和测试用途；它适合检查客户端实现、key 规范和多 key 命令的设计，不应被当作固定节点地址配置。

同槽确认后，还要检查标签粒度

同槽只是满足路由条件，不会自动提供事务、锁或数据安全。更常见的反作用是标签过粗：如果大量无关 key 都使用 {global}，多 key 操作确实容易同槽，但读写压力也会集中到一个槽，集群的其他主节点无法替它分担。

比较稳妥的取舍是让标签覆盖“同一次多 key 操作必须一起出现的最小实体”。用户资料与用户配额可以使用 {userId}；互不协同的日志、计数器和缓存不要为了前缀整齐而共用标签。遇到超高频实体时，还要重新评估是否能拆成单 key 操作或使用更细的业务分片标识。

常见问题

两个 key 前缀相同，就一定同槽吗？

不一定。没有有效花括号标签时，Redis 会对完整 key 计算；只有标签内容相同，才可以期待同槽，最终仍应使用 CLUSTER KEYSLOT 确认。

空的 {} 能当作标签吗？

不能。有效标签必须包含至少一个字符；空花括号不会截取标签内容，完整 key 会参与计算。

槽位数字相同就说明两个 key 在同一台机器吗？

它说明两个 key 的 hash slot 相同。稳定拓扑下该槽位由同一个主节点负责，但节点归属可能在迁移或重分片后变化，不能把数字硬编码成永久地址。

最后可以用一句话复查：先列出必须同槽的最小 key 集合，再把实体标识写进非空花括号，随后用 CLUSTER KEYSLOT 比较返回值，并独立评估标签是否会制造热点。