在 Redis 里执行 Lua,需要把整段脚本交给服务端,而不是在客户端逐条拼命令。常用入口有三个:直接用 EVAL 执行脚本内容;先用 SCRIPT LOAD 把脚本缓存到服务端并拿到 SHA1,再用 EVALSHA 按摘要调用;或者用客户端库封装的脚本接口(多数语言都支持后把这两步包起来)。脚本执行期间服务端不会穿插其他命令,因此适合做「读—判断—写」这类需要原子性的小逻辑。动手前先定三件事:脚本里访问哪些 key、这些 key 是否通过 KEYS 显式传入、脚本做了哪些写操作。这三点决定了它在单机、主从和集群下能否直接使用。
如果只是把多条无关命令合并以减少往返,用不用 Lua 差别不大;真正适合的场景是「条件不满足就不能写」的原子判断。建议先在redis-cli里用EVAL跑通最小脚本,再用SCRIPT LOAD+EVALSHA接入客户端;脚本必须通过 KEYS/ARGV 传参,集群下所有 key 要落在同一个 slot。上线前重点确认脚本执行时长、能否被 SCRIPT KILL 中断,以及脚本缓存失效后客户端是否有回退到EVAL的处理。
先确认当前场景和目标
先判断这件事值不值得改成脚本。常见成立的前提有三类:一是多步操作之间有条件依赖,例如「值等于期望值才更新」,用普通命令需要 WATCH/MULTI 兜底,脚本更直接;二是希望把几次往返压成一次调用,且逻辑本身很短;三是需要一段固定逻辑在多个服务间保持一致,避免各语言各自实现一遍。反过来说,如果脚本里出现循环遍历大集合、批量删除大量 key,或者需要在脚本里做外部调用,那基本可以排除。
动手前需要确认的环境信息包括:Redis 部署形态是单机、主从还是 Cluster,集群模式下跨 slot 的 key 会直接报错;服务端版本对脚本复制方式和只读变体的支持情况,不同版本行为有差异,需要结合自己环境确认;客户端库是否提供脚本对象或 SHA1 缓存机制,是否会在收到 NOSCRIPT 时自动重载。还有一个容易被跳过的判断:脚本里是否需要「部分成功」,如果业务上要求全部成功或全部不生效,那 Lua 不提供回滚,脚本里中途报错时,前面的写入已经生效,这类场景要重新设计或改用其他方式。
按这个顺序处理
第一步,在命令行里把最小逻辑跑通,不要一上来就写进业务代码。下面是一个可替换的通用示例,用 KEYS 传目标 key,用 ARGV 传期望值和写入值:
-- cas.lua:仅当当前值等于期望值时才写入
-- KEYS[1] 目标 key;ARGV[1] 期望旧值;ARGV[2] 新值
local cur = redis.call('GET', KEYS[1])
if cur == ARGV[1] then
return redis.call('SET', KEYS[1], ARGV[2])
end
return nil
在 redis-cli 中执行时,数字 1 表示后面跟着几个 key,替换成自己的 key 名与参数即可:
EVAL "return redis.call('SET', KEYS[1], ARGV[1])" 1 demo:key hello
SCRIPT LOAD "local cur = redis.call('GET', KEYS[1]) if cur == ARGV[1] then return redis.call('SET', KEYS[1], ARGV[2]) end return nil"
EVALSHA <上一步返回的sha1> 1 demo:key hello world
第二步,把脚本落到文件里,通过客户端加载。各语言客户端写法不同,但结构一致:注册脚本、声明返回类型、传入 key 列表和参数。下面是一段可替换的骨架,类名以自己项目使用的客户端版本为准:
DefaultRedisScript<String> script = new DefaultRedisScript<>();
script.setScriptSource(new ResourceScriptSource(new ClassPathResource("scripts/cas.lua")));
script.setResultType(String.class);
String result = redisTemplate.execute(
script,
Collections.singletonList("demo:key"),
"hello", "world");
第三步,如果是集群部署,把需要一起操作的 key 用 hash tag 归到同一个 slot,例如 user:{1001}:name 和 user:{1001}:score,花括号内的内容相同就会被分配到同一节点。脚本内部不要自己拼接 key 名,全部从 KEYS 取,这样既能在集群下被正确路由,也方便后续排查。

改完后怎么验证
先在命令行验证语义:把期望值设成不匹配的内容执行一次,观察返回是否是 nil 且 key 的值没有变化;再设成匹配的内容执行一次,观察返回是否是 OK 且值已更新。同样的参数重复执行两次,结果应当稳定一致,这是判断脚本是否只做了确定性操作的最直接办法。
接着验证脚本缓存状态:用 SCRIPT EXISTS <sha1> 看返回是否为 1,确认脚本已在服务端缓存;执行一次 SCRIPT FLUSH 后再用 EVALSHA 调用,正常情况下会得到 NOSCRIPT 错误,这一步是用来确认客户端是否有回退到 EVAL 重新加载的逻辑,如果不回退,线上遇到主从切换或服务重启就会大面积失败。
最后看执行开销:用 SLOWLOG GET 检查脚本是否进入了慢日志,用 INFO commandstats 观察脚本相关命令的调用次数是否符合预期。预期信号是脚本耗时处于和普通命令同一量级、没有出现长耗时记录;如果出现明显的长耗时条目,说明脚本里的数据量或逻辑复杂度超出了合适范围,需要拆小。
容易忽略的边界
脚本执行期间会占住服务端,其他命令都要等它结束,因此脚本里不要写无界循环、不要对大集合做全量遍历,也不要依赖脚本内的耗时逻辑。服务端对脚本有执行时长限制,超时后脚本不会自动终止,此时只有脚本尚未产生写入时才能用 SCRIPT KILL 中断,已经写入过的话只能靠重启实例恢复,这一点在写脚本时必须提前规避。
复制与持久化行为也需要确认:不同版本对脚本的复制方式不同,脚本里如果使用了随机类命令(例如基于随机数的分支),在部分配置下可能导致主从数据不一致,建议把随机性放到客户端生成后通过 ARGV 传入。集群模式下跨 slot 访问会直接报错,这不是脚本写法问题,而是 key 设计问题,需要提前用 hash tag 规划。
回退建议:如果脚本体积不断变大、逻辑分支越来越多,说明它已经不适合放在 Redis 侧,可以退回「普通命令 + WATCH/MULTI」或者把判断逻辑挪到应用层;如果只是担心脚本缓存丢失,保留一份脚本原文,在捕获到 NOSCRIPT 时重新 SCRIPT LOAD 即可。任何脚本改动都建议先在非生产实例上跑一遍上面的验证步骤,再替换线上脚本。