Redis FUNCTION DUMP 怎样导出函数库二进制内容

如果要把 Redis 中已经加载的函数库保存下来，使用 FUNCTION DUMP，不要把它和读取 Lua 源码混为一谈。这个命令返回的是所有已加载函数库的序列化二进制载荷，适合写入文件，之后再交给 FUNCTION RESTORE 恢复。

官方地址：https://redis.io/docs/latest/commands/function-dump/

FUNCTION DUMP 导出的到底是什么

Redis Functions 是以函数库为单位加载到服务端的。FUNCTION DUMP 导出的不是某一个函数名，也不是可以直接阅读的 Lua 文件，而是当前实例中全部函数库的序列化表示。这个边界很重要：文件可以用于迁移或备份，但不能当成源码文本修改。

官方命令参考把它描述为“返回已加载库的序列化载荷”，并说明该载荷可以稍后交给 FUNCTION RESTORE。因此，导出文件的主要价值是保留可恢复的库状态，而不是提供一份适合人工编辑的脚本备份。

怎样把二进制载荷保存成文件

在可以连接目标 Redis 的机器上，使用原始输出模式把返回值直接重定向到文件：

# 使用原始输出，避免终端把二进制载荷显示成转义文本
redis-cli --raw FUNCTION DUMP > functions.dump

# 用文件大小做传输前的记录，不把二进制内容打印到终端
wc -c 

--raw 的作用是让客户端按原始字节输出；如果省略它，终端为了可读性展示的转义字符不应被当作备份文件内容。这个命令只覆盖导出文件，不会修改 Redis 中已经加载的函数库。

导出范围是当前实例里的全部函数库，所以文件大小会随着函数数量和库内容变化。官方文档给出的时间复杂度为 O(N)，当实例函数很多时，应把导出当作一次有成本的管理操作安排，而不是在高峰期频繁执行。

恢复时如何处理已有函数库

恢复动作要看目标实例是否已经存在同名库。下面的命令把文件作为最后一个参数传给 FUNCTION RESTORE：

# -x 从标准输入读取最后一个参数；这里把整个二进制文件作为载荷传入
redis-cli --raw -x FUNCTION RESTORE REPLACE 

REPLACE 适合你明确要用导出内容覆盖同名库的场景，但它可能替换目标实例上的现有版本。若目标实例有其他库需要保留，可以考虑 APPEND；如果希望先清空现有函数库，再加载导出内容，则使用 FLUSH。这三个选项是恢复策略，不是导出文件的格式。

用什么结果判断导出或恢复是否合理

如果只想确认文件有没有被截断，可以先记录字节数并比较传输前后的文件大小；这只能说明文件传输边界一致，不能替代目标实例上的函数列表检查。

相关问题

FUNCTION DUMP 会导出单个函数吗？

不会。它面向当前实例已加载的全部函数库，不能按单个函数名筛选。

导出的文件能用文本编辑器打开吗？

不建议。载荷是序列化二进制内容，编辑器中的乱码或转义显示不是可靠的源码视图。

FUNCTION DUMP 会改变 Redis 数据吗？

导出本身用于读取函数库状态，不会像 FLUSH 那样删除已加载函数；真正改变目标函数库的是后续的 RESTORE 策略。