如何在Redis 7.0中用Functions替代Lua分布式锁?

阿敏君_6651

阿敏君_6651

2026-10-14

762人浏览

原创

redis functions不能复用旧lua锁脚本,必须重写为带#!lua name=xxx头、显式注册函数的库;function load提供持久化、复制、跨节点可用保障,但语法更严格。

如何在redis 7.0中用functions替代lua分布式锁?

不能直接复用旧Lua锁脚本,必须重写为函数库并显式注册;FUNCTION LOAD 比 SCRIPT LOAD 多出持久化、复制、跨节点可用三大保障,但代价是语法更严格、初始化逻辑不能省。

FUNCTION LOAD 和 SCRIPT LOAD 在分布式锁场景下的实际差异

旧版 Lua 分布式锁依赖 SCRIPT LOAD + EVALSHA,但主从切换后从节点执行 EVALSHA 会报 ERR NOSCRIPT No matching script——因为脚本只存内存,不落盘也不复制。而 FUNCTION LOAD 把整个函数库写入 AOF/RDB,并通过主从同步推送到所有节点,FCALL 可直接在任意节点运行。

这意味着:锁逻辑部署一次,全集群生效;Redis 重启后函数仍在;无需客户端做“脚本预热”或重载判断。

  • SCRIPT LOAD 是临时缓存,适合调试或单次原子操作,不适合生产级锁
  • FUNCTION LOAD 是数据库对象,需带 name=xxx 声明库名,且同一库名重复注册必须加 REPLACE
  • 锁的 key 初始化、过期设置、value 校验等逻辑,仍靠 redis.call() 完成,但调用入口变成 FCALL 而非 EVALSHA

重写分布式锁函数时必须处理的三个关键点

旧 Lua 锁脚本(如 setnx+expire 或 uuid+lua 删锁)不能直接粘贴进 Functions,因为 Functions 不接受裸脚本,且不自动包裹原子上下文——你得自己写清楚每一步是否容错、是否要判空、是否要防重入。

  • 必须以 #!lua name=mylocklib 开头,否则 FUNCTION LOAD 拒绝解析
  • 获取锁时,不能再依赖 SET key value NX PX 10000 一行搞定;要拆成 redis.call('set', key, val, 'NX', 'PX', 10000) 并检查返回值是否为 "OK"
  • 释放锁必须显式校验 value 是否匹配:if redis.call('get', key) == argv[1] then redis.call('del', key) end,漏掉这步就等于开放误删
  • 函数必须通过 redis.register_function('acquire', handler) 和 redis.register_function('release', handler) 显式注册,否则 FCALL mylocklib.acquire 找不到入口

FCALL 参数传入和原子性边界怎么把握

Functions 的原子性跟 Lua 一样,整个函数体执行期间 Redis 不调度其他命令。但参数传递方式变了:原来 Lua 脚本里 KEYS[1] 和 ARGV[1] 是隐式绑定的,现在你要在 FCALL 命令里明确列出 key 数量和参数顺序。

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

例如锁 key 是 lock:order:123,客户端唯一标识是 node-abc-456,超时 30 秒:

FCALL mylocklib.acquire 1 lock:order:123 node-abc-456 30000

对应函数内要这样取:

local key = keys[1]
local val = argv[1]
local ttl = tonumber(argv[2])
  • key 列表长度必须与 FCALL 第二个参数一致,多一个少一个都会导致 keys[i] 访问越界
  • 所有数字参数(如 TTL)必须用 tonumber() 转换,Lua 默认当字符串处理,直接传给 redis.call('set', ... 'PX', ttl) 会失败
  • 不支持默认参数或可选参数,缺一个 argv 就得报错或 fallback,不能靠 table.getn(argv) > 1 灵活适配

别忽略函数库名冲突和版本回滚成本

函数库名在集群中全局唯一,FUNCTION LIST 输出里每个 library_name 对应一个独立命名空间。如果你上线了 mylocklib,又想灰度测试新版逻辑,不能改名再上——得用 FUNCTION REPLACE 覆盖,但老版本就没了。

虽然 Redis 支持 FUNCTION FLUSHDB mylocklib 1 回滚到某版本,但前提是:你记得版本号,且没执行过 FUNCTION FLUSHALL 清空全部函数。

  • 生产环境建议用带环境前缀的库名,比如 mylocklib-prod-v1,避免测试库污染线上命名空间
  • 每次 FUNCTION REPLACE 都生成新版本,但 Redis 不自动清理旧版本,长期运行可能堆积大量废弃函数体
  • 函数调试比 Lua 更麻烦:没有 redis.log() 级别的实时输出,只能靠返回值或外部监控观察行为

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

redis

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
什么是分布式
什么是分布式

分布式是一种计算和数据处理的方式,将计算任务或数据分散到多个计算机或节点中进行处理。本专题为大家提供分布式相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1993

5

分布式和微服务的区别
分布式和微服务的区别

分布式和微服务的区别在定义和概念、设计思想、粒度和复杂性、服务边界和自治性、技术栈和部署方式等。本专题为大家提供分布式和微服务相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.07

2974

5

function是什么
function是什么

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

2023.08.04

2980

5

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

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

2023.10.07

494

5

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

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

2023.11.02

4429

19

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

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

2023.11.14

3955

11

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

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

2024.04.02

7272

6

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

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

2024.04.07

643

6

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

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

2024.04.07

756

6

热门下载

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

精品课程

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

共0课时 | 0人学习