不能只靠SETEX或EXPIRE设置固定TTL,因其无法根据访问频次、业务事件等动态调整过期时间;需用Lua脚本原子性地“读-判-设”TTL,并通过ARGV传参、TTL检查、EXPIRE相对设值等方式安全实现动态过期控制。

为什么不能只靠 SETEX 或 EXPIRE 设置固定 TTL
Redis 的 SETEX 和单独调用 EXPIRE 只能设置静态过期时间,一旦写入就无法根据后续访问、业务状态或数据热度动态调整。比如用户画像缓存,刚写入时希望 1 小时过期,但如果该用户 5 分钟内连续访问,其实该缓存价值很高,不该机械地在 60 分钟后失效;又比如库存缓存,下单成功后必须立即失效,但无法靠固定 TTL 捕获这个事件。
用 Lua 脚本原子性地“读-判-设”TTL
Lua 脚本在 Redis 中是原子执行的,适合把「检查当前值状态 → 决定是否延长/重置 TTL → 执行操作」三步合并为一个不可分割的动作。关键不是“脚本多酷”,而是避免客户端先 GET 再 SETEX 之间的竞态窗口。
- 必须用
redis.call("TTL", KEYS[1])获取当前剩余 TTL,而不是依赖客户端本地时间判断 - 如果返回
-2(key 不存在)或-1(key 存在但无过期),需按业务逻辑分支处理,比如直接设新 TTL 或拒绝更新 - 慎用
redis.call("EXPIREAT", ...):它依赖绝对时间戳,客户端时钟不同步会导致误失效;优先用redis.call("EXPIRE", ...)设相对秒数 - 示例场景:每次读取商品缓存时,若剩余 TTL 小于 300 秒,自动延长至 1800 秒:
if redis.call("EXISTS", KEYS[1]) == 1 then local ttl = redis.call("TTL", KEYS[1]) if ttl < 300 and ttl > 0 then redis.call("EXPIRE", KEYS[1], 1800) end end return ttl
如何安全地让缓存“被业务事件触发失效”
单纯靠访问延长 TTL 不够,订单创建、库存扣减这类写操作必须主动干预缓存生命周期。Lua 脚本在这里不是用来“删缓存”,而是做条件性失效 —— 比如只在库存真实变更时才清除,避免误删还在使用的旧快照。
- 不要在 Lua 里用
DEL粗暴删除,除非你确认 key 一定存在且必须清空;更稳妥的是redis.call("PERSIST", KEYS[1])去掉过期时间,再由下一次读逻辑决定是否重建 - 传入参数用
ARGV传递业务信号,例如ARGV[1] == "stock_decreased"时才触发清理,避免脚本逻辑和业务耦合过死 - 注意 Lua 脚本最大执行时间默认 5 秒,复杂判断(如遍历 hash 字段比对)容易超时,应把计算逻辑尽量前置到客户端
踩坑最多的地方:KEYS 和 ARGV 的边界与序列化
很多人写的 Lua 脚本在测试环境 OK,上线后随机失败,问题常出在 KEY/ARGV 传入方式不对。Redis 对 KEYS 做了严格校验(只允许字符串,且必须提前声明),而 ARGV 是自由字符串数组,但 JSON、布尔值、空值都会被转成字符串,容易引发隐式类型错误。
-
KEYS必须是真实存在的 key 名,不能是拼接结果(如"user:"..ARGV[1]),否则报错(error) ERR Error running script (call to f_...): @user_script:1: WRONGTYPE Operation against a key holding the wrong kind of value - 用
tonumber(ARGV[1])转数字前务必检查是否为nil或空字符串,否则 Lua 报attempt to perform arithmetic on a nil value - 如果需要传结构化数据(如多个字段更新条件),别手写 JSON 解析 —— 先在客户端序列化为字符串,Lua 里用
string.match或简单string.find提取关键字段更可靠
真正难的不是写对一段 Lua,而是想清楚「哪部分逻辑必须塞进原子脚本」和「哪部分可以放回客户端做轻量预判」。边界模糊时,宁可多一次 round-trip,也别把超时风险或类型转换塞进 Redis。


















