Redis 与缓存 / 系统课时

理解集群命令限制

理解集群命令限制

本课解决 Redis Cluster 中常见的 CROSSSLOT 错误。你将理解为什么多键命令、事务和 Lua 脚本要求相关键位于同一槽位,并用 Hash Tag 设计可执行的键集合。

学习目标

  • 识别会触发跨槽限制的操作
  • 让事务和 Lua 脚本只访问同槽键
  • 在键设计阶段控制跨分片耦合

为什么会出现 CROSSSLOT

一个命令若要同时访问多个键,执行节点必须一次看到全部数据。不同槽位可能由不同主节点负责,因此跨槽 MGET、MSET、集合运算、事务和脚本无法由单个节点原子完成。

Redis Cluster 不会自动把一条多键命令拆到多个节点再合并,因为这样会改变命令的原子性、错误语义和执行顺序。客户端只能在发送前校验槽位,或让服务端返回 CROSSSLOT。

主示例

下面先触发一次跨槽错误,再使用 Hash Tag 完成同槽批量读取、事务和 Lua 脚本。

bash
redis-cli -c -p 7000 MGET user:1:name user:2:name

redis-cli -c -p 7000 MSET \
  "user:{1}:name" alice \
  "user:{1}:level" 5

redis-cli -c -p 7000 MGET \
  "user:{1}:name" \
  "user:{1}:level"

redis-cli -c -p 7000 <<'EOF'
SET "account:{42}:route" 1
MULTI
SET "account:{42}:balance" 100
SET "account:{42}:status" active
EXEC
EOF

redis-cli -c -p 7000 EVAL \
  "local a=redis.call('GET',KEYS[1]); local b=redis.call('GET',KEYS[2]); return {a,b}" \
  2 "user:{1}:name" "user:{1}:level"

预期输出

text
(error) CROSSSLOT Keys in request don't hash to the same slot
OK
1) "alice"
2) "5"
OK
OK
QUEUED
QUEUED
1) OK
2) OK
1) "alice"
2) "5"

事务中的三个键共享 {42},脚本中的两个键共享 {1},因此它们都能在单个主节点执行。命令行可能额外显示重定向提示,但业务结果应一致。

事务与脚本边界

MULTI 与 EXEC 之间涉及的键必须属于同一槽位。Lua 脚本也应只访问通过 KEYS 明确传入的同槽键,不能根据运行时数据再拼接并访问其他槽位的键。

同槽并不表示所有业务都应塞进一个标签。Hash Tag 应围绕账户、订单或租户等明确聚合边界设计,既满足必要的原子操作,又避免把全部数据压到一个节点。

跨分片操作怎么做

确实需要跨分片统计、批处理或查询时,可按槽位或节点拆分请求,在应用层并行执行并汇总结果。此时它不再是单条原子命令,必须明确处理超时、部分失败、重试和幂等。

对强一致要求很高且经常跨聚合修改的数据,应重新评估数据模型,而不是不断扩大 Hash Tag 范围。必要时可把协调逻辑放到数据库、消息系统或专门的业务服务中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解集群命令限制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通