Redis SET 怎样覆盖值但保留原 TTL

如果一个 Redis 字符串键已经有过期时间，直接用 SET key new-value 更新内容时，最容易忽略的是它也会处理这个键的过期设置。只想换值、希望缓存仍然沿用原来的倒计时，可以在 SET 末尾加上 KEEPTTL：SET key new-value KEEPTTL。

官方文档：https://redis.io/docs/latest/commands/set/

下面只围绕字符串键说明这个选项。判断是否成功时，要同时看新值和剩余 TTL；不要只看到命令返回 OK 就认为过期策略符合预期。

普通 SET 为什么会让缓存时间不符合预期

SET 的核心动作是把键的字符串值设为新内容。若命令没有携带过期参数，普通覆盖并不会替你“读取并恢复”旧的倒计时。于是，更新逻辑和缓存续期逻辑混在一起时，很容易出现两种问题：一是原本会很快失效的键被更新后变成长期存在；二是开发者为了补救而重新写一个固定的 EX，却把原来已经消耗掉的时间重置了。

例如，下面的第一条命令给键设置 120 秒过期，第二条只更新值：

# 先写入带 120 秒倒计时的缓存值
redis-cli SET profile:42 "v1" EX 120

# 普通 SET 只表达“覆盖值”，不要把它误当成保留 TTL 的写法
redis-cli SET profile:42 "v2"

# 用秒级 TTL 观察当前剩余时间
redis-cli TTL profile:42

真正的剩余秒数会随时间变化，示例不应把某个固定返回数字当成结论。关键在于：普通 SET 没有明确表达“沿用原过期时间”这个意图。

用 KEEPTTL 覆盖值但保留原倒计时

把写入命令改成下面这样：

# 只替换字符串值，保留 profile:42 已经存在的过期时间
redis-cli SET profile:42 "v2" KEEPTTL

# 读取新值，确认内容已经更新
redis-cli GET profile:42

# 再读取剩余 TTL，数值会继续自然递减
redis-cli TTL profile:42

KEEPTTL 的含义是保留这个键已有的 time to live。它不会把 TTL 冻结，也不会把倒计时重新设为创建时的数值；命令完成后，剩余时间仍会继续减少。

为什么要同时用 TTL 和 PTTL 看结果

TTL 返回秒级剩余时间，PTTL 返回毫秒级剩余时间。更新前后分别读取一次，可以确认值发生了替换，同时过期计时没有被重新初始化：

# 更新前分别记录秒级和毫秒级剩余时间
redis-cli TTL profile:42
redis-cli PTTL profile:42

# 保留原 TTL，只替换缓存内容
redis-cli SET profile:42 "v3" KEEPTTL

# 更新后再次读取，值应为 v3，TTL 应继续递减而非回到 120 秒
redis-cli GET profile:42
redis-cli TTL profile:42
redis-cli PTTL profile:42

检查时要给命令执行和网络传输留出时间，所以前后数字不必完全相同。通常只需要关注两个事实：GET 得到新值，TTL/PTTL 仍是正数并且没有突然恢复为初始过期时长。

四个容易混淆的边界

1. KEEPTTL 只对已有 TTL 的键有“保留”可言

如果键不存在，SET missing-key value KEEPTTL 会创建字符串键，但没有旧的过期时间可以继承。已有但没有过期时间的永久键，也不会因为 KEEPTTL 自动获得 TTL。需要新建或主动续期时，应明确使用 EX、PX、EXAT 或 PXAT，不要期待 KEEPTTL 产生一个默认倒计时。

2. 需要只更新已存在的键，再加 XX

KEEPTTL 解决的是过期设置，XX 解决的是“键必须已经存在”。两者可以组合：

# 只有 profile:42 已存在时才覆盖，并保留它当前的 TTL
redis-cli SET profile:42 "v4" XX KEEPTTL

如果键不存在，带 XX 的 SET 不会创建它。这个组合适合“缓存命中后刷新内容，但不意外造出新键”的写入路径；如果业务允许首次写入，则不要机械添加 XX。

3. KEEPTTL 不能与 EX、PX 等过期选项同时使用

SET 的过期选项是互斥的。下面两条命令表达了两种不同意图，不能把它们拼在一起：

# 选择固定的 60 秒过期时间：这是重新设置 TTL
redis-cli SET profile:42 "v5" EX 60

# 选择继承原 TTL：这是保留已有 TTL
redis-cli SET profile:42 "v6" KEEPTTL

如果一次命令同时出现 EX、PX、EXAT、PXAT 或 KEEPTTL 中的多个选项，应把它改成单一明确的过期策略。

4. TTL 返回 -1 和 -2 时要分开理解

用秒级 TTL 检查时，-1 通常表示键存在但没有过期时间，-2 表示键不存在。实际排查可以先用 GET 或 EXISTS 判断键状态，再结合 TTL 区分“永久键”和“已删除/未创建”。

一张表记住参数怎么选

结论

需要“只换缓存内容，不动原过期策略”时，使用 SET key value KEEPTTL。如果还要求键必须已经存在，就组合 XX；如果要重新设定倒计时，就选择 EX/PX 等单一过期选项，而不是和 KEEPTTL 混用。最后用 GET 加 TTL 或 PTTL 检查值和时间两个维度。

相关问题

SET KEEPTTL 会让 TTL 停止递减吗？

不会。它只是保留已有的过期设置，剩余时间仍会继续递减。

永久键使用 KEEPTTL 后会自动过期吗？

不会。没有旧 TTL 就没有可继承的倒计时；要过期必须明确设置 EX、PX、EXAT 或 PXAT。

怎样避免更新缓存时意外创建新键？

在需要“只更新已有键”的场景使用 XX，再根据是否要保留已有 TTL 决定是否加 KEEPTTL。