Redis 7.4 HEXPIRE 如何给哈希字段单独设过期时间：FIELDS 参数与返回值核对

一个 Hash 里同时放着用户资料和临时验证码时，给整个 key 设置 TTL 往往太粗：验证码应先失效，资料字段却还要保留。Redis 7.4 提供的 HEXPIRE 可以只给指定 Hash 字段设置过期时间，关键是把 FIELDS 后面的字段数量和字段名写对，并用 HPTTL 复查结果。

HEXPIRE key seconds FIELDS numfields field [field ...] 针对字段设置秒级过期时间；返回值和 HPTTL 的结果要结合起来看，不能只凭命令执行成功判断字段已经按预期过期。

为什么整键 EXPIRE 不适合混合生命周期的 Hash

先看一个常见的用户会话 Hash：

HSET user:42 name "Lin" code "682913" session_note "from-mobile"
EXPIRE user:42 900

这两条命令让 name、code 和 session_note 共用 900 秒。验证码可能只应该存 60 秒，而用户资料还要继续被读取。把 key 拆成多个 key 能解决问题，但会增加命名、清理和读取路径。字段级过期把生命周期放回 Hash 内部，适合字段数量明确、访问仍以同一个 key 为主的场景。

最小写法：HSET 后只让指定字段进入过期队列

先创建 Hash，再对临时字段执行 HEXPIRE：

HSET user:42 name "Lin" code "682913" session_note "from-mobile"
HEXPIRE user:42 60 FIELDS 1 code
HPTTL user:42 FIELDS 1 code
HGETALL user:42

这条命令的调用链很短：HSET 写入字段，HEXPIRE 为 code 设置秒级期限，HPTTL 读取字段剩余毫秒数，HGETALL 最后确认 Hash 的可见内容。图中节点与正文命令一一对应。

如果 HPTTL 返回一个接近 60000 的非负值，说明字段已经有期限；HGETALL 此时仍能看到 name 和 code，因为倒计时还未结束。

FIELDS 参数怎么读，返回值代表什么

FIELDS 后先写数量，再写对应数量的字段名：

HEXPIRE user:42 300 FIELDS 2 code session_note

这里的 2 不是过期秒数，而是后面要处理的字段数。命令会为 code 和 session_note 分别设置 300 秒期限。批量处理时，返回数组中的每个位置对应一个字段；字段不存在、条件不满足和设置成功的状态不能混为一谈，应该保留字段顺序记录下来。

需要毫秒精度时使用 HPEXPIRE，语义相同但时间参数按毫秒解释。生产代码里不要把 HEXPIRE 的秒数直接复制到 HPEXPIRE，否则 60 会从 60 秒变成 60 毫秒。

用 HPTTL 和 HGETALL 做两次验收

设置期限后，先看剩余时间，再看字段集合：

HPTTL user:42 FIELDS 2 code session_note
HGETALL user:42

HPTTL 适合确认倒计时是否存在：正数表示仍有剩余时间，特殊负值用于表示没有期限或字段不存在。不要把所有负值都解释成同一种故障。随后执行 HGETALL，可以确认未过期字段仍在，已过期字段则不会出现在结果里。图中的 field expiration 就是这个字段级生命周期变化。

字段到期后，Hash 可能仍然存在，因为 name 等字段还在。只有最后一个字段也被删除时，才需要再观察整个 key 是否消失。这个差异是字段级过期和整键 EXPIRE 最容易混淆的地方。

版本、条件选项和三个容易踩的坑

Redis 版本必须先核对

HEXPIRE 是 Redis 7.4 引入的命令。客户端能连接 Redis，不代表服务端一定认识它；部署前用 COMMAND INFO HEXPIRE 检查目标实例，而不是只看客户端库版本。

NX、XX、GT、LT 不是字段创建开关

这些条件选项控制期限如何更新：NX 只在字段当前没有期限时设置，XX 要求字段已有期限，GT 和 LT 用于比较新旧期限。它们不会替代 HSET，也不会创建不存在的字段。

续期要防止把期限越改越短

验证码重发时，如果业务语义是“只能延长”，优先考虑 GT；如果语义是“每次重发重新倒计时”，才直接设置新值。先明确策略，再决定是否允许覆盖旧期限。

适合落地的边界

字段级过期适合把短生命周期属性和稳定属性放在同一 Hash 的系统，例如一次性验证码、临时风控标记和会话附加信息。若每个字段都需要独立查询、独立批量扫描或复杂审计，拆成独立 key 可能更清楚；若运行环境低于 Redis 7.4，则应继续使用独立 key 或由应用层维护清理。

相关问题

HEXPIRE 会删除整个 Hash 吗？

不会，它只影响指定字段。Hash 中还有其他字段时，key 仍可读取。

怎么判断字段没有设置过期时间？

使用 HPTTL 查询该字段，并按官方返回值语义区分无期限、字段不存在和仍在倒计时。

HEXPIRE 和 EXPIRE 能同时使用吗？

可以，但它们作用层级不同：EXPIRE 控制整个 key，HEXPIRE 控制字段。两者同时存在时，先到期的层级会先影响读取结果。

收束

把 FIELDS 的数量、时间单位和返回值状态写进验收逻辑，Redis 7.4 的 HEXPIRE 就不只是一个新命令，而是可控的字段生命周期工具。实际接入时保留 HPTTL 和 HGETALL 的复查步骤，能较快分辨命令没生效、字段本来不存在，还是字段已经自然到期。