Redis 哈希字段过期应该用什么命令组合

Redis 哈希字段过期的最小组合是：先用 HSET 写入字段，再用 HEXPIRE key seconds FIELDS numfields field... 给指定字段设置 TTL。Redis 7.4 开始支持字段级过期；如果运行的是 Redis 8.0 及以上，并且希望“写值时同时设置过期”，可以改用 HSETEX。检查剩余时间使用 HTTL，不要把只针对整键的 EXPIRE 误当成字段过期命令。

结论很简单：已有字段只补过期，用 HEXPIRE；写入和过期要一起完成，用 Redis 8.0+ 的 HSETEX；验证字段 TTL，用 HTTL。

先分清字段过期和整键过期

Hash 的 key 下面可以有多个 field。EXPIRE user:1001 300 会让整个 user:1001 在 300 秒后消失，用户资料、登录令牌和偏好字段都会一起失效。字段级过期只删除指定 field，其他 field 仍然保留。

因此，缓存中“同一个对象的不同字段有不同生命周期”时，应该把过期策略绑定到字段，而不是把整个 Hash 作为一个整体处理。

Redis 7.4+：HSET 后接 HEXPIRE

如果 Redis 版本在 7.4 或更高，最通用的写法是先写字段，再给一个或多个字段设置秒级 TTL。FIELDS 后面的数字必须等于随后提供的字段数量。

# 先写入两个字段，field 和 value 必须成对出现
redis-cli HSET user:1001 profile "basic" login_token "abc"

# 只让 login_token 在 300 秒后过期，不影响 profile
redis-cli HEXPIRE user:1001 300 FIELDS 1 login_token

# 读取指定字段剩余 TTL，返回秒数
redis-cli HTTL user:1001 FIELDS 1 login_token

需要给多个字段设置同一 TTL 时，可以写成 FIELDS 2 profile login_token。如果 TTL 为零或负数，字段会被立即删除；实际接入时应把 TTL 的合法范围作为业务输入的一部分处理。

Redis 8.0+：写值和过期用 HSETEX

当应用要求“字段写入成功就必须带上过期时间”，Redis 8.0+ 可以使用 HSETEX。它把字段值和过期选项放在一条命令中，适合令牌、短期状态或带租约的缓存字段。

# 在同一条命令中写入字段，并设置 300 秒的秒级 TTL
redis-cli HSETEX user:1001 EX 300 FIELDS 1 login_token abc

# 继续使用 HTTL 检查字段的剩余 TTL
redis-cli HTTL user:1001 FIELDS 1 login_token

HSETEX 还支持毫秒、绝对时间和 KEEPTTL 等选项，但这些选项要和目标 Redis 版本及客户端命令映射保持一致。若服务仍是 Redis 7.4，不能把 HSETEX 当作兼容写法，回退到 HSET 加 HEXPIRE。

用 HTTL 检查，再处理条件和回退

HTTL 返回字段剩余秒数。返回负值时要区分“字段不存在”和“字段存在但没有 TTL”这两类情况，不能只把任何负数都当成网络故障。若只想在字段没有过期时间时设置 TTL，可在 HEXPIRE 后使用 NX；已有 TTL 时才更新可用 XX。GT 和 LT 则用于限制新 TTL 必须比当前 TTL 更长或更短。

需要恢复为永久字段时使用 HPERSIST key FIELDS numfields field...。更新字段值时也要注意生命周期语义：覆盖字段可能清掉原有 TTL，业务若要“刷新值但保留过期策略”，应明确选择支持保留 TTL 的写法或在写入后重新设置。

命令组合速查与常见误区

最后，先确认服务端版本，再确认客户端是否暴露这些新命令；不要仅凭客户端方法名判断服务端支持。对 Redis 7.4，使用 HSET 与 HEXPIRE 是兼容面更清晰的方案；对 Redis 8.0+ 的原子写入需求，再考虑 HSETEX。

相关问题

HEXPIRE 能给多个字段设置不同 TTL 吗？

同一条命令使用同一个秒数。不同 TTL 应按字段分别调用，或按业务重新组织写入命令。

为什么 EXPIRE 后某个字段没有单独过期？

因为 EXPIRE 针对的是 Hash key，不针对 field。要让某个 field 单独消失，使用 HEXPIRE 或毫秒版本的 HPEXPIRE。