Redis CROSSSLOT 错误怎样用 key tag 重写键名

在 Redis Cluster 中，CROSSSLOT Keys in request don't hash to the same slot 不是 key 不存在，而是同一条多键操作找到了不同的 hash slot。最直接的修复是：把必须一起操作的业务键改成共享同一个 {...} 内容的 key tag，例如 user:{42}:profile 和 user:{42}:cart。如果这些键本来就不需要原子地一起处理，就应该拆分命令，而不是为了消除报错把整个业务都塞进一个 slot。

官方地址：https://redis.io/docs/latest/

先用 CLUSTER KEYSLOT 找到 CROSSSLOT 原因

排查时先把报错中的每个 key 单独拿出来计算 slot。比如下面两个用户键没有共享 tag，很可能被分到不同节点：

# 查看两个 key 各自的 hash slot，先确认是否是路由不一致
redis-cli -c -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT user:42:profile
redis-cli -c -h 127.0.0.1 -p 6379 CLUSTER KEYSLOT user:42:cart

# 多键命令需要这些 key 能由同一个节点处理
redis-cli -c -h 127.0.0.1 -p 6379 MGET user:42:profile user:42:cart

如果两个 CLUSTER KEYSLOT 返回值不同，MGET 等命令就可能返回 CROSSSLOT。这和 MOVED 不一样：MOVED 表示客户端连到了非负责节点，通常由集群客户端重定向；CROSSSLOT 则是一次请求本身跨了 slot。

用同一个业务标识重写 key tag

把需要一起读取、写入或参与同一事务的业务标识放到花括号中。Redis Cluster 会只对 tag 内容计算 slot，所以前后缀可以表达数据用途：

# {42} 是共享 hash tag，profile 和 cart 会落到同一个 slot
redis-cli -c MSET user:{42}:profile "..." user:{42}:cart "..."

# 两个 key 的 slot 应保持一致，便于多键命令路由到同一节点
redis-cli -c CLUSTER KEYSLOT user:{42}:profile
redis-cli -c CLUSTER KEYSLOT user:{42}:cart
redis-cli -c MGET user:{42}:profile user:{42}:cart

选择 tag 时优先使用天然的聚合边界，例如用户 ID、订单 ID 或会话 ID。不要把固定字符串 {all} 放进所有键，也不要只因为名称相似就假定它们同槽；必须让真正需要一起操作的键共享同一个 tag。

事务和 Lua 也要把所有 KEYS 放进同一 slot

Redis Cluster 对多键操作的限制不只针对 MGET。一个 MULTI/EXEC 事务或一次 EVAL/EVALSHA 执行中涉及的键，也应使用同一个 hash tag。脚本不要在正文之外偷偷拼出未声明的 key，而应把键作为 KEYS 参数传入：

# 两个 KEYS 共用 {42}，事务可以由同一个 slot 负责
redis-cli -c MULTI
redis-cli -c HSET user:{42}:profile name "小林"
redis-cli -c SADD user:{42}:roles editor
redis-cli -c EXEC

# Lua 脚本显式接收同槽的两个 key，避免跨槽访问
redis-cli -c EVAL "return redis.call('MGET', KEYS[1], KEYS[2])" 2 \
  user:{42}:profile user:{42}:cart

上面的示例只表达命名与参数边界；实际客户端应使用支持 Cluster 的连接器，由客户端负责把请求发送到目标节点。若业务要求跨用户、跨订单聚合，硬塞到一个 tag 往往会牺牲分片均衡，此时应重新设计读写边界。

别为了消灭报错制造热点 slot

hash tag 解决的是“相关键要由同一节点处理”，不是“所有键都应该同槽”。如果大量用户都使用相同 tag，某个 slot 会承受更多读写；重新分片也不能把同一 tag 内的键拆到不同 slot。

最终排查顺序可以固定为：列出请求中的全部 key，计算每个 key 的 slot，判断这些 key 是否真的需要同一条原子操作；需要就共享业务 tag，不需要就拆分或改模型。这样既能消除 CROSSSLOT，也不会把路由问题变成新的容量问题。

常见问题

花括号放在 key 名里就一定会同槽吗？

只有满足 Redis Cluster 的有效 hash tag 规则时，花括号中的内容才会参与 slot 计算。实际改名后仍应通过 CLUSTER KEYSLOT 检查，避免空花括号或不一致的 tag。

同一个 tag 会让多个 key 变成一个 Redis key 吗？

不会。tag 只影响路由计算，user:{42}:profile 和 user:{42}:cart 仍然是两个不同的 key。

用 hash tag 后还会遇到 MOVED 吗？

仍可能遇到。MOVED 是节点路由或拓扑变化相关的响应，支持 Cluster 的客户端应按拓扑重定向；hash tag 只解决多键请求之间的 slot 一致性。