讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Redis 7.0中持久化保存和备份Lua Functions?

酷雪酱_1693

酷雪酱_1693

发布时间:2026-09-17 06:55:29

|

605人浏览过

|

来源于php中文网

原创

Redis 7.0 的 FUNCTION LOAD 命令自动将函数库写入 AOF/RDB 持久化文件,无需额外操作;必须以 #!lua name=xxx 开头声明,重复注册需加 REPLACE 参数,备份即备份整个数据目录。

如何在redis 7.0中持久化保存和备份lua functions?

FUNCTION LOAD 会自动写入 AOF/RDB,不需要额外操作

Redis 7.0 的 FUNCTION LOAD 命令本身就会把函数库内容作为数据库对象写入持久化文件(AOF 或 RDB),只要你的 Redis 实例开启了对应持久化方式,函数就天然具备落盘和复制能力。这和旧版 SCRIPT LOAD 完全不同——后者只缓存在内存里,重启即丢。

常见错误现象:SCRIPT LOAD 后在从节点执行 EVALSHA 报错 ERR NOSCRIPT No matching script;换成 FUNCTION LOAD 后,主从同步正常,FCALL 可直接调用。

验证是否生效,可检查:
- CONFIG GET appendonly 是否为 yes(AOF 开启)
- CONFIG GET save 是否有有效配置(RDB 触发条件满足)
- 执行 FUNCTION LIST 查看函数库是否出现在输出中,且重启后仍存在

必须显式指定 REPLACE 才能更新已注册的函数库

同一个函数库名(name=xxx)只能注册一次,重复执行 FUNCTION LOAD 会报错 ERR Library already exists。这不是 bug,是设计约束:函数库名全局唯一,用于标识和版本管理。

更新函数逻辑时,必须加 REPLACE 参数:

Redis 8.2.3
Redis 8.2.3

Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行(RCE)的高危漏洞(CVE-2025-62507),并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级,以保障生产环境的系统稳定与数据安全。

下载
FUNCTION LOAD REPLACE "#!lua name=mylib\nreturn 'hello'"

注意点:
- REPLACE 是强制覆盖,没有确认机制,上线前建议先在测试环境验证脚本逻辑
- 不带 REPLACE 的失败不会影响已有函数运行,但部署流程会中断
- 函数库名一旦被占用,无法通过 FUNCTION DELETE 删除(7.0 当前不支持删除,仅支持覆盖)

函数必须以 #!lua name=xxx 开头声明,否则加载失败

Redis Functions 不接受裸 Lua 代码,必须包含 shebang 风格的头部声明,指明引擎类型和库名。漏掉或格式错误会导致 FUNCTION LOAD 直接报错,例如:

FUNCTION LOAD "return 1"

→ 报错:ERR Invalid function header: missing #! prefix

正确写法示例:

FUNCTION LOAD "#!lua name=rate_limit\nredis.register_function('limit', function(keys, args) return 1 end)"

关键要求:
- 必须以 #!lua 开头(目前仅支持 Lua 引擎)
- name=xxx 中的 xxx 不能含空格、斜杠、控制字符,建议只用字母数字和下划线
- 声明行之后才是实际 Lua 代码,中间不能有空行或注释干扰解析

备份函数库等同于备份整个 Redis 数据目录

因为函数库已作为数据对象写入 AOF/RDB,所以常规 Redis 备份手段完全适用:定期拷贝 dump.rdb、压缩归档 appendonly.aof、或使用 redis-cli --rdb 远程拉取快照。不需要单独导出函数。

但要注意两个易忽略点:
- 如果只启用 AOF,务必确认 appendfsync 策略不是 no,否则宕机前最后一秒的函数注册可能丢失
- 混合持久化(aof-use-rdb-preamble yes)下,函数信息只存在于 RDB 段,AOF 日志里不记录 FUNCTION LOAD 命令本身

生产建议:
- 使用 BGSAVE + WAIT 确保快照完成后再归档
- 在备份脚本末尾加一句 FUNCTION LIST | wc -l 校验函数数量是否与预期一致

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
function是什么
function是什么

function是函数的意思,是一段具有特定功能的可重复使用的代码块,是程序的基本组成单元之一,可以接受输入参数,执行特定的操作,并返回结果。本专题为大家提供function是什么的相关的文章、下载、课程内容,供大家免费下载体验。

2500

2023.08.04

js函数function用法
js函数function用法

js函数function用法有:1、声明函数;2、调用函数;3、函数参数;4、函数返回值;5、匿名函数;6、函数作为参数;7、函数作用域;8、递归函数。本专题提供js函数function用法的相关文章内容,大家可以免费阅读。

434

2023.10.07

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4009

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3515

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

6232

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

583

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

696

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5642

2024.04.07

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

0

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn