Redis键过期由服务端原生实现,采用惰性删除(GET时检查)和定期删除(每100ms随机扫描),Spring Boot不参与过期判断;@Cacheable不支持动态TTL,需通过RedisCacheConfiguration配置全局或按cacheName差异化TTL;续期需绕过Cache抽象层,推荐Lua脚本原子操作;监听过期事件须开启Redis的notify-keyspace-events Ex配置。

Redis过期机制本身不依赖Spring Boot
Redis的键过期是服务端原生能力,Spring Boot只是调用它。你写redisTemplate.opsForValue().set("key", "val", Duration.ofMinutes(5)),底层发的是SETEX命令,Redis收到后就记下TTL,后续由它自己按“惰性删除+定期删除”策略清理——Spring Boot全程不参与过期判断或触发。
常见错误现象:以为加了@Cacheable就自动带续期,结果缓存读着读着就没了;或者在application.yml里配了spring.cache.redis.time-to-live,但没确认是否生效(该配置只影响RedisCacheManager默认配置,不作用于RedisTemplate)。
- 惰性删除:GET时检查过期,过期则删并返回null —— 你代码里
redisTemplate.opsForValue().get("key")可能突然返回null,不是bug,是Redis行为 - 定期删除:Redis每100ms随机扫一批过期key,但不保证准时——30分钟过期的key,可能30分12秒才真正消失
- 别指望“精确到秒”的过期:受扫描频率和负载影响,实际延迟通常在毫秒到几秒级
@Cacheable注解无法动态设TTL
@Cacheable压根没有timeToLive属性,写@Cacheable(timeToLive = 60)会编译报错。所有声称支持该字段的博客,要么用了自定义注解,要么混淆了Spring Cache和Redis原生命令。
真正可控的路径只有两条:
- 全局统一TTL:在
RedisCacheConfiguration里调用.entryTtl(Duration.ofMinutes(10)),所有走这个CacheManager的缓存都按此时间过期 - 按cacheName差异化TTL:必须声明多个
@Bean RedisCacheManager,每个绑定不同RedisCacheConfiguration,再用@Cacheable(cacheManager = "xxx")显式指定 - 漏掉
.cacheDefaults(config)会导致entryTtl()完全不生效,缓存变成永不过期
需要访问时续期?绕开@Cacheable直接操作Redis
Spring Cache原生不支持“读取即刷新TTL”,RedisCache.get()内部只调GET,不会发EXPIRE。想实现用户每次查订单都延长30分钟有效期,就得跳过抽象层。
推荐用Lua脚本保证原子性:
String script = "local val = redis.call('GET', KEYS[1])\nif val then\n redis.call('EXPIRE', KEYS[1], ARGV[1])\nend\nreturn val";
然后执行:
redisTemplate.execute(new DefaultRedisScript<>(script, String.class),
Collections.singletonList("order:123"), "1800");
不用Lua的话,至少分两步并校验:
- 先
redisTemplate.opsForValue().get("key") - 再
redisTemplate.expire("key", 1800, TimeUnit.SECONDS),注意检查返回值——false说明key已不存在,得重新加载数据 - 别用
StringRedisTemplate配opsForValue().set()再expire(),它底层是SETEX,key存在时会覆盖值但不重置TTL
监听key过期事件要改Redis配置
Redis默认关闭键空间通知,__keyevent@0__:expired频道不会发消息。必须手动改redis.conf:
- 找到
notify-keyspace-events行 - 设为
Ex(E=启用事件,x=过期事件) - 重启Redis,否则
KeyExpirationEventMessageListener永远收不到消息
Spring Boot里监听器能捕获到的只是“key被删除”这一瞬间,不包含原value。如果业务需要根据过期订单ID查DB更新状态,得提前把ID存进key名(如order:timeout:123),靠解析key字符串还原上下文。
生产环境务必确认Redis的maxmemory-policy设为volatile-ttl,否则内存满时可能误删未过期的key。


















