Redis hash-field 过期命令的字段级缓存设计

如果一个用户 hash 里同时放着长期资料、短期会话提示和临时开关，给整个 key 设置一个 TTL 往往太粗：短期字段会拖到长期字段一起失效，长期字段又可能因为一次刷新被整体续命。Redis 7.4 引入的 HEXPIRE、HPEXPIRE、HEXPIREAT 等命令，可以把过期时间下沉到 hash field；Redis 8.0 的 HGETEX 还可以在读取时同时调整字段过期策略。

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

先把一个 hash 拆成不同生命周期

可以把 user:42 设计成一个 hash：profile 保存相对稳定的展示资料，session_hint 保存短期会话提示，feature_flag 保存临时灰度标记。三者共享 key 的管理边界，却不共享失效时间。

这个模型解决的是“字段级缓存”，不是把 Redis 变成数据库。原始数据仍应有明确来源；缓存字段过期后，业务要能从来源重建，不能因为某个 field 被淘汰就破坏核心流程。

用 HSET 与 HEXPIRE 建立字段 TTL

写入和过期设置最好分成两个明确动作：先确保 field 有值，再给确实存在的 field 设置过期时间。HEXPIRE 的时间单位是秒，作用范围由 FIELDS 后面的 field 列表决定；一次指定多个 field 时，复杂度随 field 数量增长。

# 先写入长期字段与短期字段，避免给不存在的字段设置 TTL
redis-cli HSET user:42 profile '陈晨' session_hint 'welcome' feature_flag 'checkout-v2'

# 只让短期字段在 1800 秒后失效，profile 不受影响
redis-cli HEXPIRE user:42 1800 FIELDS 1 session_hint

# 灰度开关设置 900 秒 TTL，并用 LT 防止误把短 TTL 改成长
redis-cli HEXPIRE user:42 900 LT FIELDS 1 feature_flag

NX 只在字段当前没有过期时间时设置，XX 只对已有 TTL 的字段生效；GT 与 LT 分别用于只延长或只缩短过期时间。缓存续期策略要和业务语义一致：固定窗口通常直接重设，滑动窗口则必须明确“什么访问算续期”。

用 HTTL 读出字段的真实状态

字段级 TTL 的排查不能只看 HGET 返回是否为空。HTTL 返回秒级剩余时间，HPTTL 返回毫秒级剩余时间；字段不存在、字段没有 TTL、字段已过期等状态需要按命令文档定义分别处理，不能把负数统一当成“缓存没命中”。

# 读取短期字段的剩余秒数，用于日志或监控采样
redis-cli HTTL user:42 FIELDS 1 session_hint

# 需要更细粒度的窗口时读取毫秒级 TTL
redis-cli HPTTL user:42 FIELDS 1 feature_flag

# 只读取值；业务代码要把“值为空”和“字段不存在”纳入自己的回源策略
redis-cli HGET user:42 session_hint

生产代码可以把 field 名称、TTL 返回值和回源原因写入结构化日志，但不要在日志中记录敏感字段值。监控更适合统计“无 TTL 字段数量”“即将过期字段数量”和“回源次数”，从而发现续期策略是否把短期数据错误地变成了长期数据。

读取时续期：HGETEX 的版本边界

如果业务是“读取一次就把该字段续期”，Redis 8.0 的 HGETEX 可以在读取一个或多个 field 的同时使用 EX、PX、EXAT、PXAT 或 PERSIST 调整字段生命周期。这适合有明确滑动窗口的短期数据。

# Redis 8.0：读取 session_hint，并把它的滑动窗口重置为 1800 秒
redis-cli HGETEX user:42 EX 1800 FIELDS 1 session_hint

# 读取 feature_flag，同时移除该字段的过期时间；只在业务确实要长期保留时使用
redis-cli HGETEX user:42 PERSIST FIELDS 1 feature_flag

在低于 8.0 的版本中不要直接发送 HGETEX。可以先用 HGET 读取，再按业务条件调用 HEXPIRE，但这两个动作不是一个原子命令；并发访问下可能出现读取后续期失败、重复续期或刚读取就过期的窗口。若这个窗口影响正确性，应升级到支持目标命令的版本，或把状态转移设计成服务端脚本并单独评估权限。

上线前检查权限、审计和回退

字段级过期能力进入生产前，至少要把下面几项写进发布清单：

Redis 官方文档是命令语义和版本边界的依据；部署环境还要结合实际 Redis 发行版、代理层和客户端能力做兼容性确认。不要只因为客户端能发送字符串命令，就默认服务端已经支持该命令。

常见问题

字段级 TTL 能不能替代所有缓存设计？

不能。它只解决同一 hash 内不同字段需要不同生命周期的问题；回源、一致性、淘汰和容量规划仍要单独设计。

为什么 HGET 有值但 HTTL 没有倒计时？

字段可能存在但从未设置 TTL，或者之前被 PERSIST 移除了过期时间。应把“无 TTL”作为独立状态处理，而不是误认为命令失败。

什么时候应该使用 HGETEX？

只有在 Redis 版本和客户端都支持，并且“读取即续期”的滑动窗口是明确业务规则时才使用；固定窗口缓存不必为了省一次调用而强行续期。