讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

如何在Redis7.0中创建并持久化存储自定义Lua函数?

轻宇君_9374

轻宇君_9374

发布时间:2026-11-12 08:23:08

|

485人浏览过

|

来源于php中文网

原创

Redis 7.0 的 FUNCTION LOAD 命令本身不持久,函数仅存于当前进程内存;真正持久化需配合 redis.conf 中的 function-load 配置项,使服务启动时自动加载函数脚本,否则重启即丢失。

如何在redis7.0中创建并持久化存储自定义lua函数?

Redis 7.0 的 FUNCTION LOAD 命令本身不保证函数在重启后仍存在——它只是把函数注册进当前运行实例的内存中。要真正持久化,必须配合 Redis 的 RDB/AOF 持久化机制,并确保函数注册发生在服务器启动流程中(例如通过 redis.conf 的 function-load 配置项),否则重启即丢失。

FUNCTION LOAD 后函数不持久?这是默认行为

执行 FUNCTION LOAD REPLACE 注册的函数只存在于当前 Redis 进程内存里。即使你开启了 RDB 或 AOF,Redis 默认**不会自动将已注册的函数序列化到磁盘**。这意味着:

  • 服务重启后,FUNCTION LIST 返回空数组
  • 所有 fcall 调用都会报错 ERR unknown command `fcall` 或 ERR unknown function `xxx`
  • SCRIPT LOAD(旧版 Lua)的脚本同样不持久,但那是另一套机制

真正持久化的唯一可靠方式:用 redis.conf 的 function-load

Redis 7.0+ 支持在配置文件中声明函数加载路径,服务启动时自动执行 FUNCTION LOAD。这是目前唯一被官方确认可跨重启持久的方案:

  • 把函数脚本(如 omicron.lua)放在宿主机固定路径,比如 /etc/redis/functions/omicron.lua
  • 在 redis.conf 中添加一行:function-load /etc/redis/functions/omicron.lua
  • 确保该文件权限允许 Redis 进程读取(如 chmod 644)
  • 重启 Redis:redis-cli shutdown 后重新启动,或用 systemctl restart redis
  • 验证:redis-cli FUNCTION LIST 应能立刻看到函数

注意:function-load 只在启动时触发一次,不支持热重载;修改脚本后必须重启 Redis 才生效。

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载

别踩坑:FUNCTION LOAD 的 REPLACE 和作用域陷阱

即使你手动执行 FUNCTION LOAD REPLACE,也容易因两个低级错误导致函数注册失败或调用崩溃:

  • unpack(args) 必须加 local 声明,否则会写入只读表 —— 报错 ERR user_function:7: Attempt to modify a readonly table
  • 函数定义前的 #!lua name=xxx 是必需的,且 name 值不能含空格或特殊字符,否则 FUNCTION LOAD 直接拒绝解析
  • 使用 REPLACE 是安全的,但若库名冲突且没加 REPLACE,命令会返回 ERR library already exists
  • redis.register_function() 的第二个参数必须是函数引用(如 test_round2),不能写成 test_round2()(带括号就变成调用)

Docker 环境下必须挂载函数文件并显式配置

如果你用 Docker 运行 Redis 7.0+,光把 .lua 文件 COPY 进镜像不够,因为容器启动时默认不读取自定义配置:

  • 在 redis.conf 中写好 function-load /path/in/container/xxx.lua
  • 启动容器时,用 -v 把宿主机函数文件和配置文件都挂载进去:-v /host/functions:/functions -v /host/redis.conf:/etc/redis/redis.conf
  • 确保 redis-server /etc/redis/redis.conf 启动命令明确指定了配置路径,否则 function-load 不生效
  • 不要依赖 docker exec -it redis sh -c "cat xxx.lua | redis-cli -x FUNCTION LOAD" —— 这种方式注册的函数在容器重启后必然消失

函数持久化的本质不是“存进 Redis”,而是“让 Redis 每次启动都重新注册”。漏掉配置加载环节,就等于没做持久化。

热门AI工具

更多
Loomy
Loomy Hot

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

WorkBuddy

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

UP简历
UP简历 Hot

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

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

相关专题

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

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

4929

2023.11.02

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

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

4495

2023.11.14

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

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

8712

2024.04.02

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

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

683

2024.04.07

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

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

776

2024.04.07

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

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

9062

2024.04.07

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1200

2024.04.07

redis的8种数据类型有哪些
redis的8种数据类型有哪些

redis 提供 8 种数据类型:字符串(文本、数字、二进制)、哈希(键值对)、列表(有序集合)、集合(无序唯一元素)、有序集合(按分数排序)、地理空间(地理位置)、hyperloglog(估计大数据基数)和位图(位序列存储)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1456

2024.04.07

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

热门下载

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

精品课程

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

共0课时 | 0人学习

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

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