@Cacheable注解本身不支持动态TTL,因Spring Cache抽象层设计限制,无timeToLive等属性;所有缓存共享RedisCacheManager的全局entryTtl配置,需通过RedisCacheManagerBuilderCustomizer为不同cacheName设独立TTL,或改用RedisTemplate手动控制per-key过期时间。

@Cacheable注解本身不支持动态TTL
Spring Boot 3 的 @Cacheable 注解没有 timeToLive、ttl 或类似属性——加了直接编译报错。这是 Spring Cache 抽象层的设计限制,不是配置遗漏或版本问题。
所有走同一个 RedisCacheManager 实例的缓存,最终都共享其 RedisCacheConfiguration.entryTtl() 配置值。哪怕你用 key = "#id + '_detail'" 做区分,过期时间也完全一致。
常见错误现象:
- 在
@Cacheable上写timeToLive = 300→ 编译失败,IDE 提示“unknown attribute” - 只改了
application.yml里的spring.cache.redis.time-to-live→ 全局生效,无法按 cacheName 区分 - 没重写
cacheDefaults(),却以为withCacheConfiguration("user", ...)能覆盖全局 TTL → 实际仍 fallback 到默认配置
按 cacheName 设置不同 TTL:用 RedisCacheManagerBuilderCustomizer
这是 Spring Boot 3 官方推荐、最轻量的多 TTL 方案。核心是注册一个 RedisCacheManagerBuilderCustomizer Bean,在构建阶段为指定 cacheName 注入独立 entryTtl。
实操要点:
- 必须用
@Bean显式声明该 Customizer,不能只靠配置类自动装配 -
builder.cacheDefaults()是起点,不是终点;要在此基础上调用.entryTtl(...) - 每个
withCacheConfiguration("xxx", ...)只影响对应cacheNames,不影响其他缓存 - 未显式配置的 cacheName,仍走全局默认 TTL(即
cacheDefaults()或配置文件值)
示例代码片段:
@Bean
RedisCacheManagerBuilderCustomizer redisCacheManagerBuilderCustomizer() {
return builder -> builder
.withCacheConfiguration("user",
builder.cacheDefaults().entryTtl(Duration.ofMinutes(30)))
.withCacheConfiguration("token",
builder.cacheDefaults().entryTtl(Duration.ofSeconds(120)));
}
需要 per-key 精确控制?绕过 @Cacheable,用 RedisTemplate
当业务要求“user:1001 过期 2 小时,user:1002 过期 5 分钟”,就必须放弃 @Cacheable 的自动缓存逻辑,改用 RedisTemplate 手动写入 + 设置过期。
关键细节:
- 别用
opsForValue().set(key, value, timeout, unit)——它底层发SETEX,会强制覆盖已有 key,丢失原有 TTL 或其他字段 - 正确姿势是两步:先
redisTemplate.opsForValue().set(key, value),再redisTemplate.expire(key, timeout, unit) -
expire()返回false表示 key 不存在,需检查前一步 set 是否成功(例如序列化失败、连接中断) - 确保
redisTemplate的keySerializer和valueSerializer与读取端一致,否则 get 出来是null或乱码
自定义 RedisCacheManager 继承类(慎选)
有人会搜到 TtlRedisCacheManager 或重写 createRedisCache() 的方案。这在 Spring Boot 3 中仍可行,但已非必要路径,且维护成本高:
- 你要自己 new
RedisCache实例,并传入定制的RedisCacheConfiguration - 需手动处理 cache name 前缀、空值缓存(null value)、异常兜底等原本由框架封装的逻辑
- 升级 Spring Data Redis 版本时,
RedisCacheManager构造签名可能变化,容易 break - 除非你已在用自定义
RedisCacheWriter或需深度干预缓存刷新/删除链路,否则没必要
真正容易被忽略的是:无论选哪种方式,只要 value 是对象,就必须确认 valueSerializer 支持反序列化(比如 Jackson2JsonRedisSerializer 要配好 ObjectMapper),否则缓存写进去了,读出来永远是 null。











