Redis FUNCTION LOAD注册Lua函数库的持久化

在 Redis 7 及更高版本中，FUNCTION LOAD 命令引入了函数库的概念，相较于旧的 EVAL 和 SCRIPT LOAD，它提供了更好的代码组织方式和复用性。然而，仅仅将函数加载到内存中并不足以应对服务器重启。为了确保 Lua 函数库在 Redis 重启后依然可用，必须配置持久化机制。以下是实现 Redis Lua 函数库注册与持久化的完整步骤。

准备 Lua 函数库代码

首先，编写一个符合 Redis 规范的 Lua 函数库代码。函数库必须以特定的 shebang（#!lua）开头，并声明库名。

1. 创建一个名为 mathlib.lua 的文件，并写入以下内容：

#!lua name=mathlib

local function add(a, b)
    return a + b
end

local function mul(a, b)
    return a * b
end

redis.register_function('myadd', add)
redis.register_function('mymul', mul)

这段代码定义了一个名为 mathlib 的库，并注册了 myadd 和 mymul 两个函数。

加载函数库到 Redis

使用 FUNCTION LOAD 命令将代码加载至 Redis。为了保证后续修改代码时能顺利覆盖旧版本，建议在命令中加上 REPLACE 选项。

1. 打开终端或命令行工具。
2. 执行以下命令加载 Lua 文件：

redis-cli --raw FUNCTION LOAD REPLACE "$(cat mathlib.lua)"

3. 观察返回结果。如果成功，Redis 将返回 "OK"。

验证函数调用

在配置持久化之前，验证函数是否已在内存中正确注册并可以执行。

1. 执行以下命令调用 myadd 函数，参数为 10 和 20：

redis-cli FCALL myadd 2 10 20

2. 检查输出结果。终端应显示 30。

配置 AOF 持久化

这是确保函数库在重启后存在的关键步骤。Redis 7 的 FUNCTION LOAD 命令会自动将函数内容传播到 AOF 文件和从节点，但前提是必须开启 AOF（Append Only File）持久化功能。

1. 打开 Redis 配置文件 redis.conf。该文件通常位于 /etc/redis/ 目录下。
2. 查找配置项 appendonly。
3. 修改该配置项的值为 yes：

appendonly yes

4. 保存并关闭配置文件。
5. 重启 Redis 服务以使配置生效：

sudo systemctl restart redis

如果使用的是 Docker 容器，则需重启容器：

docker restart <container_id>

验证持久化效果

重启 Redis 后，内存中的原有数据应已清空并从磁盘重新加载。此时需要确认 Lua 函数库是否自动恢复。

1. 执行之前的调用命令，无需再次加载脚本：

redis-cli FCALL myadd 2 100 200

2. 确认返回结果为 300。如果返回正确结果，说明函数库已成功通过 AOF 持久化。

理解持久化原理

为了更直观地理解 Redis 7 中函数的生命周期，请参考以下流程：

该流程展示了从执行加载命令到服务器重启恢复的全过程。

管理与维护函数库

在生产环境中，可能需要查看已加载的库或删除不再使用的函数。

1. 列出所有已注册的函数库：

redis-cli FUNCTION LIST

2. 删除指定的函数库（例如删除名为 mathlib 的库）：

redis-cli FUNCTION DELETE mathlib

注意：删除操作会同步写入 AOF 文件，因此在重启后该库依然会被删除。

常见问题处理

如果重启后发现函数丢失，请按以下步骤排查。

1. 检查 redis.conf 中的 appendonly 是否确实为 yes。
2. 查看 Redis 日志，确认 AOF 文件是否在加载时出现错误。日志位置通常在 /var/log/redis/redis-server.log。
3. 强制触发一次 AOF 重写，确保当前的函数状态被完全写入磁盘：

redis-cli BGREWRITEAOF

旧版本与新版差异对比

为了明确为何必须使用 FUNCTION LOAD 而非 SCRIPT LOAD，请参考下表：

通过以上步骤，Lua 函数库将作为 Redis 数据库架构的一部分，随 AOF 或 RDB 文件自动持久化，确保服务重启后业务逻辑不中断。