Redis怎样利用Lua为多个Key同步续期

云磊酱_1073

云磊酱_1073

2026-03-28

809人浏览

原创

EXPIRE无法原子续期多个key,因单命令仅支持一个key且网络异常会导致错期;必须用Lua脚本通过EVAL原子执行PEXPIRE批量续期,确保一致性。

redis怎样利用lua为多个key同步续期

为什么 EXPIRE 不能直接用于多个 Key 的原子续期

Redis 单个 EXPIRE 命令只能操作一个 key,而网络往返、客户端重试、中间失败都会导致多个 key 的过期时间不同步。比如你先对 order:123 续期,再对 order:123:lock 续期,中间若断连或超时,两个 key 就会“错期”——一个还活着,一个已过期,业务逻辑就可能出乱子。

真正可靠的同步续期,必须靠服务端原子执行。Lua 脚本是唯一能保证多 key 操作在单次 Redis 执行中完成的方式。

用 EVAL 执行 Lua 脚本批量续期的写法

核心思路:把要续期的 key 列表和新 TTL 作为参数传入,脚本里遍历并统一调用 PEXPIRE(推荐用毫秒级,精度更高、避免秒级截断误差)。

  • EVAL "for i=1,#KEYS do redis.call('PEXPIRE', KEYS[i], ARGV[1]) end" 2 order:123 order:123:lock 30000
  • KEYS 是 key 列表,ARGV[1] 是统一的新过期毫秒数(如 30000 表示 30 秒)
  • 注意:第一个数字 2 是 key 的数量,必须和实际传入的 key 个数一致,否则报错 ERR Error running script (call to f_...): @user_script:1: WRONGTYPE Operation against a key holding the wrong kind of value
  • 如果某个 key 不存在,PEXPIRE 返回 0,不影响其他 key,脚本继续执行

续期前要不要先检查 key 是否存在?

大多数场景下不用。续期动作本身是“保活”,不是“创建”。如果 key 已被删,PEXPIRE 返回 0,脚本照常结束,客户端可据此判断是否需重建资源。强行加 EXISTS 判断反而增加复杂度,且无法规避“检查后被删”的竞态。

但有例外:如果你依赖 key 存在作为业务状态标识(比如 user:456:session 必须存在才允许续期),那就得在脚本里显式判断:

EVAL "for i=1,#KEYS do if redis.call('EXISTS', KEYS[i]) == 0 then return 0 end end for i=1,#KEYS do redis.call('PEXPIRE', KEYS[i], ARGV[1]) end return 1" 2 user:456:session user:456:token 60000

这个版本返回 0 表示任一 key 缺失,1 表示全部续期成功。

本地缓存 + Lua 续期组合使用时的坑

常见错误是客户端一边在本地缓存了 key 的过期时间,一边又调 Lua 续期,但没同步更新本地时间戳,导致后续误判 key 过期。

  • 不要在客户端维护“预计过期时间”,只维护“最后续期时间 + TTL”,每次续期后立刻刷新这个时间点
  • Lua 脚本无法获取 Redis 服务器当前毫秒时间(redis.call('TIME') 返回的是秒+微秒,不精确),所以别指望脚本里算“剩余时间”再决定是否续期
  • 如果业务要求“只有剩余不足 5 秒才续期”,必须由客户端判断,然后决定是否发 Lua 请求;Lua 只负责“无条件续期”

最简稳的模式就是:定时轮询触发 Lua 续期,不查状态,不看剩余,只管刷 TTL。复杂判断逻辑留在应用层,别塞进 Lua。

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

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

下载

相关标签:

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

相关专题

更多
session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

2023.10.17

580

4

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

2023.10.18

876

5

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

2025.08.19

1926

14

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

1009

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

3120

5

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

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

2023.11.02

4669

19

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

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

2023.11.14

4215

11

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

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

2024.04.02

7952

6

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

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

2024.04.07

643

6

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习