Redis HGETEX 怎么只延长一个字段：字段级过期与读取结果验收

缓存用户资料时，Hash 里的 display_name 可能要保留很久，login_token 却只应该在 60 秒内有效。以前常见的做法是先 HGET，再用 HEXPIRE 补一次过期时间；Redis 8.0 提供的 HGETEX 可以把读取和字段级 TTL 设置放进同一个命令里，但它不是普通的只读命令，参数顺序和验收方式都要对上。

需要“读出字段值并同时延长它的有效期”时，用 HGETEX key EX seconds FIELDS numfields field...；读取结果用 HGET 核对，过期时间用 HEXPIRETIME 核对，别只看客户端返回值。

Redis HGETEX 解决的是哪一个缓存边界

假设 user:42 是一个 Hash，里面同时放着用户昵称和短期登录令牌：

HSET user:42 display_name "Lin" login_token "t-abc"

如果业务每次校验令牌都要把它续期 60 秒，分成 HGET 和 HEXPIRE 两个请求，会留下两个问题：应用可能读到值后在设置 TTL 前崩溃；两个请求之间也可能被其他逻辑插入。HGETEX 把字段读取和 TTL 修改作为一次 Redis 命令处理，正适合这个“读到就续期”的边界。

注意它改变了数据状态，所以不能把它当成 HGET 的别名，也不要在只读副本权限或只读连接上直接套用。

先把 HGETEX 的参数顺序写对

官方语法是：

HGETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST] FIELDS numfields field [field ...]

本例只给一个字段续期 60 秒：

HGETEX user:42 EX 60 FIELDS 1 login_token

这条命令的真实节点关系是 HGETEX 先定位 Hash，FIELDS 限定读取字段，EX 60 修改该字段的相对过期时间。返回值是字段值数组；字段不存在时，对应位置为空，而不是凭空创建字段。

图 1：HGETEX、FIELDS 与 EX 60 共同完成一次读取和续期。

EX、PX 和 EXAT 不要混成一类

EX 60 是从当前时刻起算 60 秒，PX 5000 是 5000 毫秒；EXAT 和 PXAT 则使用 Unix 时间。一个命令只能选择一种过期方式，不能把 EX 和 PX 同时写进去。

做滑动窗口缓存时更适合相对时间；需要和业务截止时刻对齐时才使用绝对时间。不要把 Unix 时间戳误放在 EX 后面，那会让 TTL 变成一个极大的秒数。

用两个读命令验收字段 TTL

发出 HGETEX 后，先看它是否返回了原值：

HGETEX user:42 EX 60 FIELDS 1 login_token
1) "t-abc"

然后分别验证值和绝对过期时间：

HGET user:42 login_token
"t-abc"

HEXPIRETIME user:42 FIELDS 1 login_token
1) (integer) 1787805803

HGET 能证明字段值没有被改写，HEXPIRETIME 能证明字段确实有过期时间。核对时允许存在几秒的执行间隔误差，重点是过期时间应接近“当前 Unix 秒数 + 60”，而不是返回 -1（无过期）或 -2（字段不存在）。示例中的时间戳只是一次命令输出，实际验收应以当前服务器时间计算。

图 2：值、过期时间和 PERSIST 的三步验收关系。

PERSIST 适合处理什么恢复场景

如果用户完成了二次验证，令牌需要从“短期字段”转为长期有效，可以使用：

HGETEX user:42 PERSIST FIELDS 1 login_token
HGET user:42 login_token
HEXPIRETIME user:42 FIELDS 1 login_token

第一条命令仍然返回字段值，但会清除该字段的过期时间。随后 HGET 仍能读到 login_token，而 HEXPIRETIME 应返回无过期状态。这里别急着用 HDEL：PERSIST 是“保留值、移除 TTL”，不是“删除字段”。

上线前检查版本、权限和失败分支

• 版本：先用 INFO server 或部署清单确认 Redis Open Source 版本不低于 8.0；旧版本不认识 HGETEX，不能靠客户端改写命令名解决。
• 权限：官方 ACL 分类把它列为 @write、@hash、@fast，连接账号只有读权限时应预期收到权限错误。
• 字段数量：FIELDS 1 后只跟一个字段；一次读取多个字段时，数量必须和后面的字段名个数一致。
• 并发语义：HGETEX 只保证这一条 Redis 命令内的读取与 TTL 修改连续处理；它不会替你完成跨命令业务事务。

相关问题

HGETEX 会给不存在的字段设置过期时间吗？

不会。它只处理已经存在的 Hash 字段；返回空值后，应由业务决定是否先写入字段，再重新设置 TTL。

HGETEX 和 GETEX 有什么区别？

GETEX 面向字符串键，HGETEX 面向 Hash 内的一个或多个字段，而且字段级 TTL 不会把同一个 Hash 的其他字段一起设置过期。

为什么 HGETEX 不能只写字段名不写 FIELDS？

FIELDS 块是命令语法的一部分，后面的数字用于界定字段数量。省略它会导致参数解析失败，而不是默认读取全部字段。

把验收命令留在回归脚本里

这个命令适合解决“读取即续期”的细粒度缓存问题，但上线前至少保留一组可重复的验收：先写入两个字段，只对 login_token 执行 HGETEX EX 60，再用 HGET 和 HEXPIRETIME 对照；最后用 PERSIST 验证只移除 TTL、不删除值。这样检查的不是客户端返回是否好看，而是 Redis 中值和过期状态是否都符合业务边界。