Redis 与缓存 / 系统课时

加载与复用 Lua 脚本

加载与复用 Lua 脚本

本课解决同一 Lua 脚本被频繁调用时重复传输脚本文本的问题。你将使用 SCRIPT LOAD 获取脚本的 SHA1 摘要,再用 EVALSHA 复用脚本,并为重启、故障切换或缓存清理后的 NOSCRIPT 建立恢复流程。

学习目标

  • 使用 SCRIPT LOAD 加载脚本并取得摘要
  • 使用 EVALSHA 按摘要重复执行脚本
  • 正确处理 NOSCRIPT 与集群节点边界

从 EVAL 到 EVALSHA

EVAL 每次请求都携带完整脚本文本;EVALSHA 只发送由脚本文本计算出的 40 个十六进制字符。脚本较长且调用频繁时,后者可以减少重复传输,也便于应用统一管理脚本版本。

SCRIPT LOAD 只把脚本加入当前 Redis 节点的脚本缓存并返回摘要,不会执行脚本。之后客户端以相同摘要调用 EVALSHA,Redis 命中缓存后才执行脚本。

Lua 脚本加载与复用流程

加载并重复执行

下面的完整 Shell 示例加载一个计数脚本,并连续执行两次。运行前需保证本机 127.0.0.1:6379 上的 Redis 可用;--raw 用于输出原始值,便于脚本处理。

bash
#!/usr/bin/env bash
set -euo pipefail

SCRIPT='return redis.call("INCRBY", KEYS[1], ARGV[1])'

redis-cli DEL counter:orders >/dev/null
SHA=$(redis-cli --raw SCRIPT LOAD "$SCRIPT")

printf 'sha=%s\n' "$SHA"
redis-cli --raw EVALSHA "$SHA" 1 counter:orders 5
redis-cli --raw EVALSHA "$SHA" 1 counter:orders 5

预期输出

text
sha=<SHA1>
5
10

<SHA1> 是脚本文本对应的摘要,实际值随脚本内容变化。两次调用复用同一摘要,键 counter:orders 的值依次变为 5 和 10。

处理 NOSCRIPT

Redis 重启、切换到未加载该脚本的节点,或执行 SCRIPT FLUSH 后,旧摘要可能无法命中,此时 EVALSHA 返回 NOSCRIPT。应用应先执行 EVALSHA,只在确认错误类型为 NOSCRIPT 时重新执行 SCRIPT LOAD,再用新返回的摘要重试一次。

不要对所有错误无条件重试。参数数量错误、脚本运行时错误或业务校验失败不会通过重新加载脚本解决,盲目重试还可能造成重复写入。

在 Redis Cluster 中,脚本缓存按节点维护,不能假设在一个节点加载后会被所有节点共享。脚本涉及多个键时,这些键还必须满足集群命令的同槽要求,否则无法执行。

管理脚本版本

摘要完全由脚本文本决定,即使只修改空格也会产生新的 SHA1。工程中应把 Lua 文件纳入版本控制,由应用保存“脚本文本—摘要”映射,并保留原始文本用于 NOSCRIPT 回退。

不要把摘要写死为唯一依赖。应用启动、连接到新节点或发生故障切换后,都应能根据原始脚本重新建立缓存。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加载与复用 Lua 脚本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通