一条 Redis 缓存写入时明明带了过期时间,更新内容后却变成了 TTL = -1。先别查清理任务:如果更新走的是普通 SET,它写入新值时会清掉原来的期限。下面用一个只监听本地 Unix socket 的临时实例复现,再用 KEEPTTL 和 EX 分别解决「保留原截止时间」和「从这次更新重新计时」两种需求。
一、先读 TTL,分清键还在不在
假设一个目录页的摘要缓存设为五分钟过期,后台后来只改了标题。写入返回成功,页面也显示了新标题,但这并不能说明五分钟的规则还在。要判断问题出在何处,先从同一个逻辑库、同一个完整键名读生命周期,再读值。不要只拿更新前的应用日志里一条「已设过期」来对比:那条日志描述的是另一次写入。
TTL 按秒返回剩余时间,PTTL 按毫秒返回。现代 Redis 中,这两个命令返回 -1 表示查询时键存在但没有过期时间,-2 表示查询时键不存在,非负值才是剩余时长。零也不是 -1:它表示按该命令的单位读到的剩余时长为零,通常已经逼近失效,下一次访问的结果可能变了。另一个写入方也可能在两次查询之间改变状态,所以不要把分开的 GET 和 PTTL 当作同一个快照。
二、普通 SET 成功时会清掉旧期限
普通 SET 会替换整个值,不是原地改里面某个字段。对已有期限的键,成功执行不带过期选项的 SET 后,只要没有其他命令再设期限,这个键就没有过期时间了。它也不会因为之前曾经倒计时,就在原时刻自动过期。这里说的「无期限」仅指没有 Redis 键级过期时间,仍可能因为主动删除、覆盖或符合当前策略的内存淘汰而消失。
这条规则也不要套到所有写命令。比如给哈希键设置键级期限,再用 HSET 改一个字段,键的原过期时间会保留。先确定客户端到底执行的是整键替换,还是对现有数据结构的修改。如果把序列化后的整个摘要当字符串存,改其中一项仍可能落成一次整键 SET。

三、保留原截止时间,还是从现在重新计时?
如果五分钟从首次生成摘要时就开始算,中途改标题也不能延长旧数据的寿命,选 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合在一个统计项里。 - 回归通过不代表历史键已经修好。先估算受影响范围,再决定是让上游重新生成,还是按业务规则有计划地补期限。
🔕 评论已关闭