EXPIRE 怎样避免刷新 TTL

Redis 的 EXPIRE key seconds 默认会把键的当前 TTL 改成新的秒数。如果业务要求“第一次设置后不再刷新”，最直接的写法是给 EXPIRE 加上 NX；如果只允许在已有 TTL 的键上更新，则使用 XX。需要控制方向时，LT 只接受更短的新 TTL，GT 只接受更长的新 TTL。

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

把“避免刷新 TTL”拆成明确规则：只首次设置用 NX，只处理已有过期时间用 XX，只缩短用 LT，只延长用 GT。命令返回 1 才表示本次真的改了过期时间，返回 0 表示条件没有满足。

先看懂 EXPIRE 为什么会刷新 TTL

无条件的 EXPIRE cache:user:42 300 不会比较旧 TTL，而是直接尝试把键的过期时间设为 300 秒。缓存命中后重复执行这条命令，就可能把本来只剩 20 秒的键重新变成 300 秒，形成“访问越多，过期越晚”的滑动效果。

这些条件参数只能四选一，不能把 NX 和 LT 叠加成一个命令。实际选择前，先明确你是在防止重复续期，还是在限制 TTL 变化方向。

用 NX、XX、LT、GT 限制更新范围

“只首次设置”通常对应缓存填充或一次性保护窗口。下面的命令会在键没有 TTL 时设置 300 秒；如果键已经有 TTL，即使它只剩 5 秒，也不会被刷新。

# NX 只在当前键没有过期时间时设置，避免重复访问把 TTL 重新拉长
redis-cli EXPIRE cache:user:42 300 NX

# XX 只处理已经存在过期时间的键，不给永久键凭空增加 TTL
redis-cli EXPIRE cache:user:42 120 XX

# LT 只接受更短的新 TTL，适合收紧缓存保留窗口
redis-cli EXPIRE cache:user:42 60 LT

# GT 只接受更长的新 TTL，适合延长仍在有效期内的缓存
redis-cli EXPIRE cache:user:42 600 GT

NX 关注的是“有没有过期时间”，XX 关注的是“已经有过期时间”；LT 和 GT 关注的是新旧过期时间的方向。Redis 文档把没有 TTL 的键视作非 volatile 键，比较 GT 或 LT 时不要把它误解成一个普通的剩余秒数。

条件版本的 EXPIRE 自 Redis 7.0 起支持 NX、XX、GT、LT。如果客户端报参数错误，应先确认服务端版本与客户端命令封装是否匹配，而不是退回到无条件刷新。

用返回值和 TTL 判断是否真的改动

EXPIRE 返回整数 1 或 0。返回 1 表示过期时间已设置；返回 0 可能意味着键不存在，也可能是条件参数阻止了更新。要区分当前状态，可以紧接着读取 TTL：-1 表示键存在但没有过期时间，-2 表示键不存在。

# 先读取剩余 TTL，避免把条件失败误判为网络故障
redis-cli TTL cache:user:42

# 只有返回 1，才把“TTL 策略已更新”写入业务日志
redis-cli EXPIRE cache:user:42 300 NX

# 用 TTL 复核键仍存在、且当前确实带有过期时间
redis-cli TTL cache:user:42

这里的复核是业务判断，不是让调用方通过“先读 TTL、再决定是否写入”来模拟条件更新。真正的条件应交给带 NX、XX、LT 或 GT 的单条命令完成，避免并发客户端之间出现先读后写的竞态。

覆盖写入时怎样保住 TTL

避免 EXPIRE 自己刷新 TTL 还不够。如果后续使用普通 SET 覆盖字符串值，Redis 会清除该键原有的过期时间。需要在更新值的同时保留旧 TTL 时，应使用 SET ... KEEPTTL；这个规则与 EXPIRE NX 是两个不同层面的保护。

# 普通 SET 会覆盖值，并清除原有 TTL；不要用于需要保留过期时间的更新
redis-cli SET cache:user:42 '{"name":"Ada"}'

# KEEPTTL 在替换字符串值时保留原有过期时间
redis-cli SET cache:user:42 '{"name":"Grace"}' KEEPTTL

# 如果更新时还要求键必须已存在，可组合 XX 与 KEEPTTL
redis-cli SET cache:user:42 '{"name":"Lin"}' XX KEEPTTL

如果键不是字符串类型，SET 本身就不适用；列表、哈希等数据结构的修改命令通常不会因为增量修改而清除 TTL，但任何会替换整个键值的命令都应单独核对过期语义。

落地选择清单

• 目标是“只设置一次”：使用 EXPIRE key seconds NX。
• 目标是“只给临时键调整”：使用 XX，避免给永久键误加 TTL。
• 目标是“不能延长”：使用 LT；目标是“不能缩短”：使用 GT。
• 更新字符串值但不能丢 TTL：使用 SET ... KEEPTTL，不要把它和 EXPIRE 的条件混为一谈。
• 把返回值 0 当作条件未满足处理，再通过 TTL 区分键不存在和无过期时间。

相关问题：

• EXPIRE NX 能和 XX 一起使用吗？不能。它们是互斥条件，分别表达没有 TTL 和已有 TTL 两种相反前提。
• 为什么 EXPIRE 返回 0？键可能不存在，也可能不满足 NX、XX、LT 或 GT 的条件；读取 TTL 可以帮助区分当前状态。
• 只用 EXPIRE NX 能防止 SET 清除 TTL 吗？不能。覆盖字符串值时还要使用 SET ... KEEPTTL，因为这是值写入命令的过期处理规则。

总结来说，避免刷新 TTL 不是把过期时间固定成某个数字，而是把更新条件写进命令：首次设置用 NX，按方向控制用 LT/GT，覆盖值时用 KEEPTTL 保住已有策略。