必须用哈希标签{}使所有KEYS落在同一slot,否则EVAL必报CROSSSLOT错误;Redis仅对{}内字符串哈希,如order:{1001}:a与order:{1001}:b同slot,而脚本内硬编码或动态拼接key均无效。

不能直接让Lua脚本“支持”跨slot多Key原子操作——Redis集群根本禁止这事。你必须让所有Key先落在同一slot,脚本才能跑起来。
为什么EVAL在集群里总报CROSSSLOT错误
Redis集群按slot分片,EVAL命令路由时只看KEYS[1]算出目标节点,然后检查其余KEYS是否也在同一slot。只要有一个不在,立刻返回-ERR CROSSSLOT Keys in request don't hash to the same slot。
- 不是Lua写得不对,是key分布违规
-
redis.call("GET", "user:"..ARGV[1])这种拼接key的写法必然失败——Redis压根没机会校验这个key属于哪个slot - 哪怕只读操作(比如多个
GET),只要key跨slot,照样报错
怎么强制多个key落到同一个slot
唯一可靠方式是用{}包裹公共部分,触发Redis的Hash Tag机制:它只对{}内的字符串做CRC16哈希,忽略外部字符。
- 正确示例:
order:{1001}:status、order:{1001}:items、order:{1001}:log→ 全部落到同一slot - 错误示例:
order:1001:status和user:1001:profile→ 毫无关联,几乎必然跨slot - 验证方法:用
CLUSTER KEYSLOT order:{1001}:status和CLUSTER KEYSLOT order:{1001}:items确认返回值一致
脚本里KEYS和ARGV怎么传才安全
集群模式下,Redis会严格校验:所有被redis.call()或redis.pcall()调用的key,必须显式出现在KEYS数组里,否则直接拒绝执行。
- 必须这样写:
redis.call("INCR", KEYS[1])、redis.call("HSET", KEYS[2], "f", ARGV[1]) - 绝不能这样写:
local k = "tmp:" .. ARGV[2]; redis.call("DEL", k)→ 触发-ERR bad lua script for redis cluster, all the keys that the script uses should be passed using the KEYS array - 参数数量要对得上:
EVAL "... " 2 key1 key2 value1中,2表示KEYS长度,后面两个参数才是KEYS,再往后才是ARGV
脚本内如何避免状态不一致
Lua脚本没有回滚能力。redis.call()一旦成功写入,就不可逆。所谓“原子性”仅指执行不中断,不等于ACID事务。
- 所有条件判断(余额够不够、key是否存在、类型是否正确)必须放在任何
redis.call()写操作之前 - 用
redis.pcall()替代redis.call()捕获异常,但别指望靠它“补偿”——已写的key不会自动撤回 - 推荐提前退出模式:校验失败时直接
return redis.error_reply("xxx"),确保零写入 - 并发安全靠key设计:比如用
lock:{1001}做业务锁,而不是在脚本里手动实现CAS逻辑
最容易被忽略的是:slot对齐不是一次性的配置,而是每次调用EVAL前都得人工保证。哪怕你用Hash Tag规范了key命名,如果客户端传参时漏掉{}或拼错,照样崩。别依赖“应该没问题”,上线前务必用真实key跑一遍CLUSTER KEYSLOT。


















