如何在Redis中用Lua原子更新Hash字段并重置过期时间?

云墨吖_6423

云墨吖_6423

2026-10-23

906人浏览

原创

hset+expire非原子操作易导致过期失效或ttl被覆盖,须用lua脚本封装:通过redis.call('hset',keys[1],argv[1],argv[2])写入字段、redis.call('expire',keys[1],tonumber(argv[3]))重设ttl,确保原子性。

如何在redis中用lua原子更新hash字段并重置过期时间?

为什么不能直接用HSET+EXPIRE组合更新Hash并续期

因为这两步不是原子的:HSET成功后,EXPIRE可能因网络中断、Redis临时不可用或命令被丢弃而失败,导致key长期不淘汰。业务上表现为“数据还在但本该过期”,尤其在分布式会话、临时配置等场景中容易引发状态错乱。更隐蔽的问题是,如果多个客户端并发执行该组合,后执行的EXPIRE会覆盖前一次设置的TTL,造成过期时间不可控。

HSET + EXPIRE必须封装进Lua脚本才能原子执行

Redis服务端保证整个Lua脚本串行执行,中间不会被打断。关键点在于:所有操作(写字段、设过期)必须在同一个EVAL或EVALSHA调用中完成,且使用redis.call()而非redis.pcall()(除非你明确要捕获错误并降级处理)。

  • redis.call('HSET', KEYS[1], ARGV[1], ARGV[2]) 写入单个field,支持覆盖或新增
  • redis.call('EXPIRE', KEYS[1], tonumber(ARGV[3])) 重置整个key的TTL;注意ARGV[3]必须是字符串形式的整数,如"3600",传3600(number)在某些Redis版本会报错
  • 若需批量更新多个field,把HSET替换成HMSET(Redis HSET带多组field/value参数(Redis ≥ 7.0),但参数总数不能超1024

读取时如何确认字段是否有效——不能只靠HGET

HGET本身不返回过期信息,哪怕key已过期但尚未被惰性删除,HGET仍可能返回旧值。真正可靠的判断方式是:先EXISTS检查key是否存在,再HGET取值。但要注意:EXISTS返回1只说明key存在且未过期,返回0可能是key真不存在,也可能是已过期但还未被清理(惰性删除机制决定的)。所以业务逻辑里应把EXISTS为0视作“不可用”,避免后续误用。

redis-tools
redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用,支持离线速查表。

下载

示例调用:
EVAL "redis.call('HSET', KEYS[1], ARGV[1], ARGV[2]); redis.call('EXPIRE', KEYS[1], tonumber(ARGV[3])); return 1" 1 user:1001 token "abc123" "1800"

高并发下更新部分字段时,别用HGETALL+HMSET重构整个Hash

常见误区是:先HGETALL读出全部字段 → 在Lua里修改其中几个 → 再HMSET全量写回。这会导致两个问题:一是大Hash(几千字段)阻塞Redis主线程;二是HGETALL返回的是扁平数组{'f1','v1','f2','v2'},遍历时容易索引错位;三是HMSET会覆盖所有未显式指定的字段,相当于“清空再重建”,破坏原语义。

正确做法是只用HSET更新目标字段,其他字段不动。如果确实需要基于原值计算(比如给score字段加1),就用HGET单独读那个field,再HSET写回,避免全量加载。

实际部署时最容易被忽略的一点:TTL刷新必须和字段更新绑定在同一脚本里,不能拆成两个独立请求;同时,客户端调用方要确保传入的过期秒数是整数字符串,否则EXPIRE会静默失败或报错ERR value is not an integer or out of range。

相关文章

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

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

下载

相关标签:

redis

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

相关专题

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

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

2023.11.02

4569

19

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

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

2023.11.14

4135

11

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

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

2024.04.02

7712

6

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

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

2024.04.07

643

6

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

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

2024.04.07

756

6

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

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

2024.04.07

7682

6

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

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

2024.04.07

1160

6

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

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

2024.04.07

1156

6

redis主要作用有哪些
redis主要作用有哪些

redis 的主要作用包括:1. 缓存数据,提高访问速度;2. 充当消息队列,实现消息传递;3. 存储各种数据类型,如字符串、散列和集合;4. 管理会话信息,确保可靠性和可用性;5. 限制请求速率,防止服务器超载等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

6678

6

热门下载

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

精品课程

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

共0课时 | 0人学习