0

0

Redis如何使用Lua封装HGET配合TTL刷新

P粉602998670

P粉602998670

发布时间:2026-03-13 09:11:02

|

578人浏览过

|

来源于php中文网

原创

不能直接用HGET+EXPIRE组合刷新TTL,因存在竞态条件:HGET后key可能立即过期导致EXPIRE失败,且并发时多个客户端执行EXPIRE仅首个成功;Lua脚本能原子执行“查+刷”,用HEXISTS和EXPIREAT确保安全续命。

redis如何使用lua封装hget配合ttl刷新

为什么不能直接用 HGET + EXPIRE 组合刷新 TTL

因为并发读时,多个客户端可能同时发现 key 过期、同时执行 EXPIRE,但只有第一个成功;更糟的是,HGETEXPIRE 之间存在竞态窗口——key 可能在 HGET 后立刻过期,导致后续 EXPIRE 失败,TTL 没刷上。

Lua 脚本在 Redis 中原子执行,能确保“查 + 刷”一步到位。核心思路是:先 HGET,若字段存在且 key 未过期(或刚过期但需续命),再用 EXPIREAT 设定新过期时间。

  • 必须用 EXPIREAT 而非 EXPIRE,避免因 Redis 时间漂移或脚本执行延迟导致误判
  • 不要依赖 TTL 返回值判断是否过期——返回 -2 表示 key 不存在,-1 表示无过期时间,0 才是已过期;但 key 存在且无 TTL 时,HGET 仍可能成功,需结合两者判断
  • 脚本里别用 redis.call("TTL", KEYS[1]) 做前置判断,它和后续操作不构成原子条件,意义不大

EVAL 脚本怎么写才安全可靠

以下是最小可用脚本,接收 KEYS[1](hash key)、ARGV[1](field)、ARGV[2](新 TTL 秒数):

if redis.call("HEXISTS", KEYS[1], ARGV[1]) == 1 then
  local ttl = redis.call("TTL", KEYS[1])
  if ttl == -1 or ttl > 0 then
    redis.call("EXPIREAT", KEYS[1], tonumber(ARGV[2]) + tonumber(redis.call("TIME")[1]))
  end
  return redis.call("HGET", KEYS[1], ARGV[1])
else
  return nil
end

注意点:

  • HEXISTSHGET 更轻量,先确认字段存在再取值,避免无谓的字符串分配
  • redis.call("TIME") 获取服务端当前秒级时间,保证 EXPIREAT 时间戳绝对可靠,不受客户端时钟影响
  • 不处理 ttl == 0(刚过期)的情况——此时 key 逻辑上已删除,HEXISTS 会返回 0,脚本直接返回 nil,符合预期
  • 如果业务要求“即使字段不存在也要刷新 TTL”,那就去掉 HEXISTS 判断,但需明确这是覆盖语义,不是读取语义

客户端调用时参数和错误要盯紧哪几个

以 Python 的 redis-py 为例,调用方式是:

AITDK
AITDK

免费AI SEO工具,SEO的AI生成器

下载
r.eval(lua_script, 1, "myhash", "field_name", str(int(time.time()) + 3600))

关键约束:

  • KEYS 数量必须传对(这里是 1),否则 Redis 报错 ERR Error running script (call to f_...): @user_script:1: WRONGTYPE Operation against a key holding the wrong kind of value
  • ARGV[2] 必须是绝对时间戳(秒),不是相对秒数——脚本里没做转换,传错会导致 key 立刻过期或几百年后才过期
  • 如果 hash key 本身不是 HASH 类型,HEXISTSWRONGTYPE,整个脚本中断,返回 Python 异常 redis.exceptions.ResponseError
  • 别把 field 名拼错进 KEYS ——Lua 里 KEYS 只能是 key 名,field 必须走 ARGV

性能和边界情况比想象中敏感

这个脚本看似简单,但在高并发下有几个隐形瓶颈:

  • 每次调用都触发两次 redis.callHEXISTS + HGET),实际是三次(还有 TTLTIME),比单次 HGET 多出 2–3 倍开销;QPS 上万时得压测看毛刺
  • 如果 hash key 极大(几十万 field),HEXISTS 仍是 O(1),但底层哈希表 rehash 可能引发短暂停顿,Redis 日志里会出现 Hash table resize 提示
  • 脚本里没做空值保护:当 ARGV[1] 是空字符串或 nilHEXISTS 返回 0,脚本返回 nil——这没问题;但如果业务允许空字段名,就得提前校验
  • 集群模式下,key 必须落在同一 slot,所以 KEYS[1] 要确保是标准 hash key(不含 {...} 标签也行,但多个 key 就不行)

真正麻烦的不是写法,而是想清楚:你到底要“读取时顺带续命”,还是“只要访问就无条件续命”。前者得检查字段存在性,后者连 HEXISTS 都可以砍掉——但多数人没想清这点,就直接抄了带判断的版本。

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

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

492

2023.10.18

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

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

382

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1567

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号