直接用RScript.evalSha()执行复杂原子运算大概率失败,根本原因是未处理脚本加载、SHA缓存、参数绑定和集群路由四环节:必须先scriptLoad获取SHA再evalSha;集群下KEYS需同slot(如加{tag});参数类型需匹配并显式转换;超长脚本会阻塞Redis单线程。

直接用 RScript.evalSha() 执行复杂原子运算,大概率会失败或行为异常——根本原因不是脚本写得不对,而是没处理好脚本加载、SHA 缓存、参数绑定和集群路由这四个环节。
脚本必须先 scriptLoad 再用 evalSha
Redisson 的 evalSha 不会自动加载脚本。如果传入的 SHA 摘要 Redis 服务端没有缓存过,会直接返回 NOSCRIPT No matching script 错误,而不是 fallback 到 EVAL。
- 必须显式调用
rScript.scriptLoad(scriptContent)获取 SHA 字符串,再传给evalSha - 生产环境建议把
scriptLoad放在应用启动时统一执行,避免运行时重复加载 - 不要在每次调用前都
scriptLoad:Redis 会拒绝重复加载相同内容的脚本,但网络开销白费,且可能触发限流
集群模式下 KEYS 必须落在同一 slot
如果你的 Lua 脚本里用了多个 KEYS(比如同时操作 stock:1001 和 order:2001),而 Redis 是集群部署,evalSha 会因 CROSSSLOT Keys in request don't hash to the same slot 报错。
- 强制所有涉及的 key 使用相同哈希标签,例如写成
{inventory}:stock:1001和{inventory}:order:2001 - 或者改用单节点模式(不推荐生产),或改用
eval(但失去 SHA 复用优势) - Redisson 不会帮你做 key 路由校验,错误只在运行时暴露
evalSha 的参数顺序和类型容易错
Redisson 的 evalSha 重载方法多,最常用的是这个签名:。注意:
-
keys参数必须是List,不能传String[]或单个String;否则会抛ClassCastException -
args是可变参数,对应 Lua 中的ARGV,但每个元素会被序列化为字符串,数值类型如Long传进去后在 Lua 里是字符串,需用tonumber()转换 -
RScript.ReturnType必须严格匹配脚本实际返回值,比如脚本返回redis.call('get', key),就该用ReturnType.VALUE,而非BOOLEAN
超长脚本或高频调用会拖垮 Redis
Redis 是单线程执行 Lua 的,一段耗时 50ms 的脚本,在 QPS 200 时就能让整个 Redis 实例卡住。这不是 Redisson 的问题,但容易被忽略。
- 脚本逻辑务必控制在 5ms 内,禁止循环遍历大集合、调用
redis.call('keys', ...)或任何阻塞操作 - 用
redis.call('exists', key)替代redis.call('get', key)再判空,减少数据传输 - 上线前用
redis-cli --eval在目标环境压测脚本延迟,别只看本地单元测试
真正难的从来不是写出能跑通的脚本,而是让脚本在集群、高并发、长期运行的场景下不翻车——scriptLoad 的时机、KEYS 的哈希一致性、参数类型的隐式转换、以及脚本本身的执行毛刺,任何一个点漏掉,都会在流量高峰时突然崩掉。











