Redis集群中Lua脚本必须所有KEYS同slot,否则报CROSSSLOT错误;唯一合法解法是用{}哈希标签(如user:{1001})强制多key路由至同一slot,且KEYS须显式传入、服务端写入时即带tag。

不能。Redis集群模式下Lua脚本**完全不允许跨节点操作不同分片**,这是硬性限制,不是配置或客户端能绕过的。
为什么EVAL/EVALSHA会直接报CROSSSLOT错误
Redis集群把16384个slot分散到多个节点,每个EVAL请求必须路由到唯一目标节点执行;而路由依据是KEYS数组里第一个key的slot。如果其他key不在同一slot,Redis在解析阶段就拒绝执行,直接返回(error) CROSSSLOT Keys in request don't hash to the same slot——连脚本体都不会加载。
- 错误示例:
EVAL "return {redis.call('GET', KEYS[1]), redis.call('GET', KEYS[2])}" 2 user:1001 order:999,两个key哈希后大概率落在不同节点 - 单机Redis不校验slot,所以本地测试通过、上集群立刻失败,极易遗漏
-
EVALSHA行为完全一致:只传sha1,但校验逻辑和EVAL完全相同
{}哈希标签是唯一合法的同slot解决方案
必须用花括号{}显式指定参与CRC16哈希计算的部分,让多个key强制落到同一slot。Redis只取第一个成对{}里的内容做哈希,其余部分被忽略。
- ✅ 正确写法:
user:{1001}:profile、cart:{1001}:pending、order:{1001}:items→ 都对1001哈希 - ❌ 错误写法:
user:1001:profile(整个字符串参与哈希)、user:{1001:profile(未闭合,行为不可控) - 嵌套
{}只认最内层第一对:user:{abc{def}:xyz实际取def算slot - 服务端写入key时就必须带tag,不能等Lua里拼接:
KEYS[1] .. ":counter"生成的新key不会被校验,运行时报ERR Lua script attempted to access a non-local key
SCRIPT KILL在集群里基本无法终止失控脚本
别指望SCRIPT KILL能救场。它只对当前连接所连节点有效,且仅适用于“阻塞等待型”脚本(如BLPOP),对纯计算型(死循环、大文本处理)完全无效。
- 你连的可能是随机节点或从节点,而脚本实际跑在负责该slot的主节点上
-
SCRIPT KILL不支持跨节点广播,没有集群级“杀所有副本”的能力 - 真正可控的方式是源头约束:客户端设
socketTimeout、服务端调小lua-time-limit、禁用Lua内for循环/JSON解析等高危操作
最容易被忽略的一点:上线前必须用redis-cli --cluster check验证打上相同tag的key是否真的落在了同一个slot;扩容或rehash后,仅靠命名规则不检查,可能突然触发CROSSSLOT。


















