RedisCacheManager的TTL只能通过RedisCacheConfiguration.entryTtl()在初始化时静态配置,@Cacheable无timeToLive属性;按cacheName差异化TTL需配置多个RedisCacheManager实例;手动续期须用RedisTemplate执行Lua脚本或分步GET+EXPIRE。

Spring Boot 里 RedisCacheManager 的过期策略不能靠 @Cacheable 注解动态控制,必须在 CacheManager 初始化阶段通过 RedisCacheConfiguration.entryTtl() 显式配置;想按 cacheName 区分 TTL,只能配多个 RedisCacheManager 实例。
RedisCacheConfiguration.entryTtl() 是唯一生效的 TTL 设置入口
你写的 @Cacheable(timeToLive = 60) 会直接编译失败——Spring 原生注解根本没有这个字段。所有“动态设 TTL”的说法,要么是自定义注解,要么是封装层,不是 Spring Cache 标准行为。
真正起作用的是 RedisCacheConfiguration.entryTtl() 方法,它返回一个新配置实例(注意:该类不可变)。常见错误包括:
- 用了
RedisCacheManager.builder(redisConnectionFactory())却漏掉cacheDefaults(config),导致entryTtl()白设,fallback 到永不过期 - 配置了
entryTtl(Duration.ofMinutes(5)),但没确认是否被实际传入RedisCacheManager构造过程 - 改了配置却没重启应用,或没触发 Bean 重建,缓存还是用旧配置
按 cacheName 差异化 TTL:必须配多个 RedisCacheManager
一个 RedisCacheManager 实例只对应一套全局 TTL 策略。想让 "user" 缓存过期 2 小时、"config" 过期 10 分钟,只能定义两个独立的 @Bean:
- 每个
@Bean返回不同名称的RedisCacheManager,例如userCacheManager和configCacheManager - 每个都绑定各自独立的
RedisCacheConfiguration,调用各自的entryTtl() -
@Cacheable(cacheManager = "userCacheManager")中的字符串必须和@Bean方法名(或@Primary指定的 name)完全一致,大小写敏感 - 注意连接池开销:每个
RedisCacheManager默认创建自己的 Lettuce 连接池,高并发下需调大max-active,否则可能耗尽连接
手动续期必须绕开 RedisCache,直接操作 Redis
RedisCache.get() 或任何基于 @Cacheable 的读取,都不会触发 EXPIRE —— Spring Cache 原生不支持访问即续期。底层调用的是 GET,不是 GETEX,更不会自动重置 TTL。
可靠做法只有两种:
- 用
redisTemplate.execute()执行 Lua 脚本,原子性完成GET + EXPIRE,例如:local val = redis.call('GET', KEYS[1])\nif val then\n redis.call('EXPIRE', KEYS[1], ARGV[1])\nend\nreturn val - 分两步:先
redisTemplate.opsForValue().get(key),再redisTemplate.expire(key, seconds, TimeUnit.SECONDS);但必须检查expire()返回值——false表示 key 已不存在,得立刻重新加载
别用 StringRedisTemplate.opsForValue().set(key, value, duration, TimeUnit.SECONDS),它等价于 SETEX,key 存在时会覆盖值但不重置 TTL,行为不可控。
混合策略才是真实业务里的常态
高频稳定数据(如字典表)适合走多 CacheManager + @Cacheable;强时效语义的数据(如 token、验证码、临时配置)一律用 RedisTemplate.set(key, value, timeout, unit) 直接写入+设过期。后者粒度最细、语义最明确,但你要自己处理序列化、空值逻辑、缓存穿透防护——Spring Cache 帮你兜底的部分,全得自己补。
最容易被忽略的一点:所有 TTL 配置都依赖于 Redis 服务端时间。如果 Redis 实例所在机器时钟漂移严重(比如没开 NTP 同步),EXPIRE 和 TTL 的行为就会失真,线上排查时务必先核对时间同步状态。











