HGETEX 怎样更新 Hash 字段过期

如果你希望“读出 Hash 字段的同时刷新它的过期时间”，Redis 8.0.0 及以上可以直接使用 HGETEX。它把读取字段和设置 TTL 放在同一条命令里：用 EX 或 PX 设相对时间，用 EXAT 或 PXAT 设绝对时间；不需要 TTL 时可以用 PERSIST 清除字段过期时间。

官方地址：https://redis.io/

HGETEX 的参数形态：读取和更新放在同一条命令里

HGETEX 的完整形态是 HGETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST] FIELDS numfields field [field ...]。其中 key 是 Hash 的键，numfields 必须等于后面列出的字段数量；字段顺序也决定返回值的对应顺序。

下面的示例读取两个字段，并把它们的相对过期时间分别设为 120 秒和 30 秒。由于一次调用只能使用一个 TTL 修饰符，所以不同 TTL 需要拆成两次调用：

# 先准备两个 Hash 字段，示例只展示命令形态。
HSET user:42 nickname "lin" session "active"

# 读取 nickname，并把该字段的 TTL 更新为 120 秒。
HGETEX user:42 EX 120 FIELDS 1 nickname

# 读取 session，并把该字段的 TTL 更新为 30 秒。
HGETEX user:42 EX 30 FIELDS 1 session

如果只想同时读取多个字段并给出同一个 TTL，可以写成 HGETEX user:42 PX 5000 FIELDS 2 nickname session。Redis 返回的值与字段请求顺序一致，不能把返回数组当成按字母排序的结果。

用 EX 或 PX 更新相对过期时间

EX 的单位是秒，PX 的单位是毫秒。所谓“更新”并不是修改 Hash 的 value，而是读取指定字段的现有值，同时替换该字段的 TTL。适合会话续期、短期状态续租这类场景。

# EX 使用秒，读取 token 并把它的 TTL 刷新为 10 分钟。
HGETEX user:42 EX 600 FIELDS 1 token

# PX 使用毫秒，适合需要更细时间粒度的短状态。
HGETEX user:42 PX 1500 FIELDS 1 challenge

不要混淆 Hash key 的整体 TTL 和字段 TTL：HGETEX 操作的是字段过期时间。如果服务端低于 Redis 8.0.0，命令本身不在该版本的能力范围内；这时应先在部署说明中确认版本与客户端支持，不要把执行失败误判为字段不存在。

绝对时间和 PERSIST 分别解决什么问题

需要让多个服务共享同一个截止时刻时，使用 EXAT 或 PXAT。它们接收 Unix 时间戳，前者以秒为单位，后者以毫秒为单位。时间戳已经在过去时，字段会按过期规则立即失效，因此生成时间戳时要统一时钟与单位。

# 绝对时间示例：1700000600 是秒级 Unix 时间戳示例。
HGETEX user:42 EXAT 1700000600 FIELDS 1 invitation

# 清除 invitation 字段上的 TTL，让它回到持久字段。
HGETEX user:42 PERSIST FIELDS 1 invitation

PERSIST 不会删除字段值，只移除该字段已有的过期时间。EX、PX、EXAT、PXAT 和 PERSIST 互斥，一次命令不能混用两个修饰符。

用 HTTL 核对 TTL，不要只看 HGETEX 返回值

HGETEX 的返回数组是字段值，不是剩余 TTL。要确认相对过期时间是否写入，可以用 HTTL 按同样的字段顺序查询：

# 按与 HGETEX 相同的字段顺序读取剩余秒数。
HTTL user:42 FIELDS 2 nickname session

# 需要查看绝对过期时间时，使用对应的时间查询命令。
HEXPIRETIME user:42 FIELDS 1 invitation

字段不存在时，HGETEX 也不会凭空创建字段；先确认 key、字段名和服务端版本，再判断业务数据是否真的已经过期。

常见问题

HGETEX 能不能一次给不同字段设置不同 TTL？

不能。一次命令只能选择一个过期修饰符和一个时间值；不同 TTL 需要按字段拆成多次调用。

HGETEX 返回空值就代表 TTL 设置失败吗？

不一定。空值首先表示请求字段没有可返回的值，TTL 是否存在应使用 HTTL 或时间查询命令单独判断。

HGETEX 和只读取字段的 HGET 有什么区别？

HGET 只读值，而 HGETEX 还会改变指定字段的过期状态，因此它属于写命令，调用前要明确续期或持久化意图。