Lua 脚本与 EVAL:原子性写法与超时治理

举报
yd_94907100 发表于 2026/11/16 08:18:59 2026/11/16
【摘要】 写对 EVAL 与 EVALSHA,用 SCRIPT KILL 兜底

"先查库存、判断够了再扣减",这类多命令逻辑用客户端代码实现必然有并发窗口,用 Lua 脚本则能在服务端一次性原子执行。Lua 是 Redis 里分布式锁续期、限流器、秒杀扣库存等场景的基石,但它跑在主线程上——一个死循环脚本能让整个实例对所有客户端装死。本文以 Redis 7 为准,讲清 EVAL 的正确写法、原子性的真实边界,以及脚本失控后的恢复手段。

一、EVAL 与原子性

EVAL "return redis.call('GET', KEYS[1])" 1 mykey

第一个参数是脚本,第二个是 key 的数量,其后依次是 KEYS 数组与 ARGV 数组。脚本内的多条命令在主线程连续执行完,期间不插入任何其他客户端命令——这就是原子性。一个典型扣库存脚本:

-- KEYS[1]=库存 key,ARGV[1]=扣减数量
local stock = tonumber(redis.call('GET', KEYS[1]))
local need = tonumber(ARGV[1])
if not stock or stock < need then
    return -1
end
redis.call('DECRBY', KEYS[1], need)
return stock - need

必须知道的真实边界:出错不回滚。脚本执行到第二条命令才报错时,第一条的写入已经生效并持久化,Redis 没有事务回滚。所以把所有校验判断放在写操作之前,用 redis.pcall 捕获可能失败的操作再决定补偿。

原子性的范围还需要更准确地界定。它保证的是"脚本执行期间不被其他客户端命令插入",但不保证"脚本执行期间不被系统动作打断"。实际上,fork(BGSAVE、AOF 重写触发)会在脚本执行前被检查,但如果脚本执行时间很长,serverCron 的一些周期性任务仍然可能在命令之间插入。更关键的是:脚本执行期间,Redis 不处理其他任何客户端请求,所以脚本本身的耗时就等于它对全实例的阻塞时长——这一点比"原子"更值得警惕。

二、写法要点

用 KEYS 传 key,用 ARGV 传数据。 这是 Cluster 兼容的硬要求:集群靠 KEYS 里的 key 计算槽位路由,把 key 藏在 ARGV 里会导致跨槽错误。同一脚本内只能操作同一槽的 key。服务端也会校验:脚本实际访问的 key 超出 numkeys 声明的范围时会被拒绝执行,这类写法在测试期就会被拦下。

返回值有类型限制。 Lua 的 number 返回会被截断成整数,EVAL "return 1.5" 0 得到 (integer) 1;要返回浮点用 tostring 转字符串,客户端再解析。返回 nil 会变成空批量字符串,注意与 0 区分。

redis.call 与 redis.pcall。 前者出错直接终止脚本并把错误返回给客户端,后者返回带 err 字段的 table,由脚本自行处理。

另外,脚本环境是沙箱:没有 os、io 等库,不能读文件、取系统时间、起协程,可用的是基础类型操作加 cjson、bit 等少数扩展;redis.setresp(3) 可切换 RESP3 协议使用新的返回类型。别指望在脚本里写业务级复杂逻辑,它是原子性工具,不是计算引擎。

EVALSHA 免去重复传脚本。 先 SCRIPT LOAD 拿到 sha1,之后用 EVALSHA sha1 numkeys ... 执行,省带宽;脚本未被缓存时报 NOSCRIPT,客户端应降级重发 EVAL。主流客户端(Jedis、Lettuce)的 script API 已内置这个降级逻辑。

Redis 7 还推出了 Functions(FUNCTION LOAD + FCALL),把脚本注册成服务端常驻函数,解决 EVALSHA 在主从切换后脚本缓存丢失的问题:

FUNCTION LOAD REPLACE "#!lua name=mylib
redis.register_function('get_stock', function(keys, args) return redis.call('GET', keys[1]) end)"
FCALL get_stock 1 stock:1001

三、脚本超时与恢复

脚本卡死是最危险的事故。相关机制有三层:

  1. busy-reply-threshold(Redis 7 由 lua-time-limit 改名而来,默认 5000 毫秒):脚本执行超过该时长后,Redis 并不会中断它,而是开始对其他命令回复 BUSY 错误——脚本本身仍在跑。
  2. SCRIPT KILL:只有脚本尚未执行过任何写命令时才能终止,实例随即恢复正常。
  3. SHUTDOWN NOSAVE:脚本已经写过数据时,SCRIPT KILL 会失败(中断会造成半写状态),此时只能关闭实例且不保存,用主从切换恢复服务。
CONFIG SET busy-reply-threshold 3000    # 3 秒后开始拒绝其他命令
SCRIPT KILL                             # 未写数据的脚本用这个终止
SHUTDOWN NOSAVE                         # 最后手段

三层机制的判断逻辑需要按顺序理清,否则现场容易误操作。第一步看 BUSY 是否出现:客户端收到的错误形如 BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.,这个错误本身就是"脚本已超过阈值"的信号。第二步查脚本有没有写过数据,直接看 SCRIPT KILL 的返回:

redis-cli SCRIPT KILL
# OK                                        → 未写数据,已终止,实例恢复
# UNKILLABLE Sorry the script already executed write commands against the dataset.
#            You can either wait the script termination or kill the server in a hard way using
#            the SHUTDOWN NOSAVE command.    → 已写数据,不能终止

UNKILLABLE 这个回复就是第三步的判据:脚本已经产生副作用,强行终止会造成半写状态,只能 SHUTDOWN NOSAVE。这里的取舍是"数据一致性优先于可用性",因为半写状态下的数据无法自动修复。所以在设计脚本时,把第一个写命令尽量往后放——只要脚本卡在写命令之前,SCRIPT KILL 就能兜底;一旦已经写过,就只剩重启这一条路。

SHUTDOWN NOSAVE 会跳过持久化直接退出,未落盘的数据全部丢失。在主从架构下,从库仍在运行,可以提升为新主,代价是丢失脚本已执行的写。执行前应当先确认从库的数据是完整的,否则会同时丢掉两边的数据。

由于脚本在主线程执行,主库装死期间写命令无法传播,从库只是短暂缺数据;Redis 7 起脚本按效果复制,从库不会重放脚本本身,恢复后追平即可。所谓效果复制,指主库把脚本实际产生的写命令(如 DECRBY、RPUSH)记入复制流,而不是把整段脚本发给从库重放。这带来两个结果:脚本可以安全地先取随机命令的结果再写库,主从不会因随机数不同而分叉;从库也不会被长脚本二次阻塞。早期版本要调用 redis.replicate_commands() 显式开启,Redis 7 已是唯一行为,该函数保留但不再必要。

运维上还要注意脚本缓存的生命周期:脚本缓存在内存里,实例重启、SCRIPT FLUSH 都会清空,之后 EVALSHA 报 NOSCRIPT。规范做法是把脚本当代码资产放进仓库评审,应用启动时统一 SCRIPT LOAD 预热,并给 NOSCRIPT 实现自动降级重试;拿脚本做限流器、分布式锁续期的组件尤其要覆盖这条路径,否则一次主从切换就可能让锁续期静默失败。

常见坑 / 最佳实践

  1. 循环必须有硬上限。 while true 或依赖外部条件的循环就是给实例上刑,遍历集合类需求改用 SCAN 分批做。
  2. 校验前置,写入靠后。 出错不回滚,把所有判断放在第一个写命令之前,失败路径零副作用。
  3. key 走 KEYS、数据走 ARGV。 藏 key 会破坏 Cluster 路由;脚本内操作多个 key 时确保同槽(hash tag)。
  4. 脚本只做短小原子操作。 复杂计算、大循环放客户端,脚本执行时长控制在毫秒级,避免触发 BUSY。
  5. 接到 BUSY 报错先 SCRIPT KILL 再查根因。 客户端对 BUSY 错误要有独立告警,别让它混在普通超时里被重试放大。

小结

  • EVAL 在主线程原子执行多命令逻辑,但出错不回滚,校验必须前置。
  • KEYS 传 key、ARGV 传数据是 Cluster 兼容铁律;Lua number 返回会被截断为整数。
  • EVALSHA 省带宽,NOSCRIPT 要降级 EVAL;Redis 7 的 Functions 解决缓存丢失问题。
  • busy-reply-threshold 超时后实例回复 BUSY 但不中断脚本;未写可用 SCRIPT KILL,写过只能 SHUTDOWN NOSAVE。
  • 脚本是强武器也是大风险,长度、循环、时长都要自我设限。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。