JavaLYG

Redis SET 更新后 TTL 变成 -1:用 KEEPTTL 保留原过期时间

一条 Redis 缓存写入时明明带了过期时间,更新内容后却变成了 TTL = -1。先别查清理任务:如果更新走的是普通 SET,它写入新值时会清掉原来的期限。下面用一个只监听本地 Unix socket 的临时实例复现,再用 KEEPTTL 和 EX 分别解决「保留原截止时间」和「从这次更新重新计时」两种需求。

一、先读 TTL,分清键还在不在

假设一个目录页的摘要缓存设为五分钟过期,后台后来只改了标题。写入返回成功,页面也显示了新标题,但这并不能说明五分钟的规则还在。要判断问题出在何处,先从同一个逻辑库、同一个完整键名读生命周期,再读值。不要只拿更新前的应用日志里一条「已设过期」来对比:那条日志描述的是另一次写入。

TTL 按秒返回剩余时间,PTTL 按毫秒返回。现代 Redis 中,这两个命令返回 -1 表示查询时键存在但没有过期时间,-2 表示查询时键不存在,非负值才是剩余时长。零也不是 -1:它表示按该命令的单位读到的剩余时长为零,通常已经逼近失效,下一次访问的结果可能变了。另一个写入方也可能在两次查询之间改变状态,所以不要把分开的 GET 和 PTTL 当作同一个快照。

二、普通 SET 成功时会清掉旧期限

普通 SET 会替换整个值,不是原地改里面某个字段。对已有期限的键,成功执行不带过期选项的 SET 后,只要没有其他命令再设期限,这个键就没有过期时间了。它也不会因为之前曾经倒计时,就在原时刻自动过期。这里说的「无期限」仅指没有 Redis 键级过期时间,仍可能因为主动删除、覆盖或符合当前策略的内存淘汰而消失。

这条规则也不要套到所有写命令。比如给哈希键设置键级期限,再用 HSET 改一个字段,键的原过期时间会保留。先确定客户端到底执行的是整键替换,还是对现有数据结构的修改。如果把序列化后的整个摘要当字符串存,改其中一项仍可能落成一次整键 SET。

Redis 给已有且带期限的键写入新值:普通 SET 清除期限,KEEPTTL 保留期限,EX 设置新期限
三栏是并列选项,适用于键已有期限且本次写入成功的情形。图中写的是命令选项简写,完整语法见下文。

三、保留原截止时间,还是从现在重新计时?

如果五分钟从首次生成摘要时就开始算,中途改标题也不能延长旧数据的寿命,选 SET key value KEEPTTL。Redis 6.0 起支持这个参数。它保留已有的过期时间,不是再发一个五分钟的倒计时。键原本无期限时,更新后还是无期限;键不存在时,如果没有条件限制,命令可以创建一个无期限的键。

如果规则是不允许更新动作重建缺失的键,可以加 XX,写成 SET key value XX KEEPTTL,并按客户端约定区分写入成功与条件未满足。XX 只要求当时键存在,不检查它是否有期限,也不检查旧值是否还是应用此前读到的版本。遇到并发覆盖,如果业务需要比较并更新,就要为这条路径另设并发控制,不靠 XX 代替。

若每次生成的新摘要都应重新拥有完整的五分钟,则用 SET key value EX 300;毫秒输入用 PX。这和保留原截止时间是两条不同路径,EX、PX 与 KEEPTTL 不能叠加。对缓存来说,「这次更新要不要延寿」看似只是一个参数,实际上决定了读者能看到旧来源内容多久。

四、起一个临时实例,把三种结果跑一遍

把这段完整代码保存为 demo.py,在有 Unix socket 的 Linux 环境用 Python 3.7+ 执行 python3 demo.py。需要 Redis 服务端 7.0+,因为实验使用 Redis 7.0 新增的 PEXPIRETIME,并需要支持 -e 的 redis-cli。本次使用 Redis 服务端和客户端 7.4.3。如果机器上有多个版本,可以把两条可执行文件的绝对路径分别作为参数。实验不读 Redis 的已有配置,不监听 TCP,不写持久化数据,退出时回收自己的进程和临时目录。若 socket 路径过长,换一个路径较短、可写的临时目录作为 TMPDIR,不要转接已有实例。

判断是否保留期限时,代码对比写入前后同一个键的绝对毫秒截止时间,而不是要求剩余毫秒数相等。后者会随着执行耗时减少,正常情况下就可能不同。验证重新计时时只判断值已更新、剩余时间在合理区间内,不把精确的毫秒读数写死。实验只核对命令行为,不涉及生产缓存、复制、故障切换或内存淘汰。

import os, subprocess, sys, tempfile, time
from pathlib import Path

if len(sys.argv) not in (1, 3):
    raise SystemExit('用法:python3 demo.py [redis-server路径 redis-cli路径]')
server, cli = sys.argv[1:] or ['redis-server', 'redis-cli']
env = {k: os.environ[k] for k in ('PATH', 'LANG') if k in os.environ}

with tempfile.TemporaryDirectory(prefix='redis-ttl-') as tmp:
    sock = str(Path(tmp) / 'r.sock')
    log = str(Path(tmp) / 'redis.log')
    command = [cli, '-s', sock, '-e', '--raw']
    proc = subprocess.Popen([
        server, '--port', '0', '--unixsocket', sock, '--unixsocketperm', '700',
        '--daemonize', 'no', '--dir', tmp, '--save', '', '--appendonly', 'no',
        '--logfile', log,
    ], env=env)
    try:
        deadline = time.monotonic() + 5
        while True:
            probe = subprocess.run(command + ['PING'], env=env,
                                   capture_output=True, text=True, timeout=1)
            if probe.returncode == 0 and probe.stdout.strip() == 'PONG':
                break
            if proc.poll() is not None or time.monotonic() >= deadline:
                raise RuntimeError('临时 Redis 未就绪;请检查版本和 socket 路径长度')
            time.sleep(0.05)

        def run(*args):
            return subprocess.run(command + list(args), env=env, check=True,
                                  capture_output=True, text=True, timeout=3).stdout.strip()

        def expect(label, actual, expected):
            if actual != expected:
                raise RuntimeError(f'{label}: 预期 {expected!r},实际 {actual!r}')
            print(label, 'OK')

        def seed(key):
            run('SET', key, 'old', 'EX', '300')
            stamp = int(run('PEXPIRETIME', key))
            if stamp <= 0:
                raise RuntimeError(f'{key} 未写入过期时间')
            return stamp

        seed('plain')
        run('SET', 'plain', 'new')
        expect('普通 SET 清除过期', (run('GET', 'plain'), run('PTTL', 'plain')), ('new', '-1'))
        stamp = seed('keep')
        run('SET', 'keep', 'new', 'KEEPTTL')
        expect('KEEPTTL 保留同一截止时间', (run('GET', 'keep'), int(run('PEXPIRETIME', 'keep'))), ('new', stamp))
        stamp = seed('reset')
        run('SET', 'reset', 'new', 'EX', '60')
        expect('EX 改用新时长', (run('GET', 'reset'), 0 < int(run('PTTL', 'reset')) <= 60000,
                              int(run('PEXPIRETIME', 'reset')) < stamp), ('new', True, True))
        run('SET', 'persistent', 'old')
        run('SET', 'persistent', 'new', 'KEEPTTL')
        expect('KEEPTTL 不会给无过期键补期限', run('PTTL', 'persistent'), '-1')
        expect('缺键初始状态', run('PTTL', 'new-key'), '-2')
        run('SET', 'new-key', 'new', 'KEEPTTL')
        expect('不加 XX 时可无期限地建键', (run('GET', 'new-key'), run('PTTL', 'new-key')), ('new', '-1'))
        expect('加 XX 时缺键不创建', (run('SET', 'missing', 'new', 'XX', 'KEEPTTL'),
                                       run('PTTL', 'missing')), ('', '-2'))
        stamp = seed('existing')
        expect('XX 可更新存在的带期限键', (run('SET', 'existing', 'new', 'XX', 'KEEPTTL'),
                                            int(run('PEXPIRETIME', 'existing'))), ('OK', stamp))
        stamp = seed('occupied')
        run('SET', 'occupied', 'new', 'NX')
        expect('NX 不写入就不清除期限', (run('GET', 'occupied'), int(run('PEXPIRETIME', 'occupied'))), ('old', stamp))
        run('HSET', 'profile', 'color', 'blue')
        run('EXPIRE', 'profile', '300')
        stamp = run('PEXPIRETIME', 'profile')
        run('HSET', 'profile', 'color', 'green')
        expect('HSET 修改字段保留键级期限', (run('HGET', 'profile', 'color'),
                                               run('PEXPIRETIME', 'profile')), ('green', stamp))
        run('SET', 'split', 'first')
        expect('两条命令之间的窗口', run('PTTL', 'split'), '-1')
        run('SET', 'split', 'second')  # 用顺序调用演示另一写入方插进来
        run('EXPIRE', 'split', '60')
        expect('后续 EXPIRE 作用于当时存在的键', (run('GET', 'split'),
                                                    0 < int(run('PTTL', 'split')) <= 60000), ('second', True))
    finally:
        if proc.poll() is None:
            proc.terminate()
            try:
                proc.wait(timeout=5)
            except subprocess.TimeoutExpired:
                proc.kill()
                proc.wait(timeout=5)
    if proc.poll() is None:
        raise RuntimeError('临时服务器未退出')
if Path(tmp).exists():
    raise RuntimeError('临时目录未清理')

五、别把先 SET 再 EXPIRE 当成等价改写

如果应用分两次发送命令,第一条 SET 成功后,键已经存在但没有期限。如果程序在发第二条之前崩溃,原计划的 EXPIRE 可能根本没到 Redis。若另一写入方刚好在中间更新了同一个键,之后的 EXPIRE 针对的是那一刻的键,不一定还是第一条 SET 写入的值。代码最后用顺序命令固定这个交错,用不着等真实并发碰巧发生。

能够确定业务就是「写新值并设一个新期限」时,优先单条 SET ... EX 或 SET ... PX,不留应用分两次提交的窗口。若业务要保留原截止时间,但目标版本不支持 KEEPTTL,不要拿固定的 EX 悄悄改成续期,也不要直接把读到的相对 TTL 再写回去;它在命令之间会变旧。应确认升级方案,或另行设计和验证原子更新逻辑。单条命令同样不保证客户端收得到成功回执:连接断开时,不要直接把错误当成服务器没写。

六、按读回结果排查

观测先核对处理方式
值更新,PTTL 从正数变为 -1更新代码是否用了不带过期选项的 SET按业务选择保留旧期限或显式写入新期限。
加了 KEEPTTL,PTTL 仍为 -1更新前键是否缺失或已经无期限不要把 KEEPTTL 当成补期限;存量修复须单独审批和验证。
使用 XX 后应用声称更新成功,键却没出现客户端是否把条件未满足的空回复当成功区分已写入和因缺键未写入;查明后续是否另有删除。
PTTL 突然变大是否存在带 EX/PX 的刷新路径,或另外执行了 EXPIRE在隔离样本中对比绝对截止时间,再核对所有写入方。
读回 -2键名、库、读写节点是否一致,是否过期或已被移除先定位缺键,不把它记录成无期限。

七、上线前验收一次真实写入入口

把过期策略写进调用方的测试预期:首次生成要有期限;更新时到底保留还是重设;缺键是重建还是拒绝;原本无期限的存量键怎么处理。这样前台写入、后台修订和批量刷新即便用的是同一个客户端,也不会因为某个通用方法没带默认参数,就把同一批键变成三种生命周期。

  • 用独立测试键从应用入口走一遍,确认实际发送的命令和成功返回值。
  • 更新前后都读回值和期限;保留路径对照 PEXPIRETIME,重设路径检查期限范围。
  • 覆盖缺键和已有无期限键,确认分支可观察;避免把返回的空值、-1 和 -2 合在一个统计项里。
  • 回归通过不代表历史键已经修好。先估算受影响范围,再决定是让上游重新生成,还是按业务规则有计划地补期限。

八、官方参考

🔕 评论已关闭