3、缓存过期时间配置方法：配置文件方式、注解方式、API动态设置方式

在 Testing 环境下，缓存过期时间的配置直接影响测试结果的稳定性和可重复性。不同的配置方式适用于不同的测试阶段与场景：配置文件方式适合全局统一管理，注解方式适合细粒度方法级控制，API 动态设置方式则适合在测试用例中实时调整。本章将系统讲解三种配置方法的核心原理、适用场景及 Testing 环境下的最佳实践。

3.1 配置文件方式

配置文件方式是缓存过期时间管理的基础手段，通过外部化配置实现缓存策略的集中管控。在 Testing 环境下，通常使用 application-test.yml 或 application-test.properties 文件覆盖默认缓存配置。

3.1.1 Spring Boot 缓存配置示例

# application-test.yml
spring:
  cache:
    type: redis
    redis:
      time-to-live: 5s          # 全局默认过期时间 5 秒
      cache-null-values: false  # 不缓存空值
      use-key-prefix: true
      key-prefix: "test:"       # 测试环境前缀，便于隔离

# 针对特定缓存名称的过期时间配置（通过 CacheManager 定制）
custom:
  cache:
    ttl:
      userCache: 3s
      productCache: 10s
      sessionCache: 2s

3.1.2 自定义 CacheManager 实现差异化 TTL

@Configuration
@Profile("test")
public class TestCacheConfig {

    @Bean
    public RedisCacheManagerBuilderCustomizer redisCacheManagerBuilderCustomizer() {
        return builder -> {
            Map<String, Duration> ttlMap = new HashMap<>();
            ttlMap.put("userCache", Duration.ofSeconds(3));
            ttlMap.put("productCache", Duration.ofSeconds(10));
            ttlMap.put("sessionCache", Duration.ofSeconds(2));

            ttlMap.forEach((cacheName, ttl) -> 
                builder.withCacheConfiguration(cacheName,
                    RedisCacheConfiguration.defaultCacheConfig()
                        .entryTtl(ttl)
                        .prefixCacheNameWith("test:" + cacheName + ":")
                )
            );
        };
    }
}

3.2 注解方式

注解方式通过 @Cacheable、@CachePut、@CacheEvict 等注解在方法级别声明缓存策略，其中过期时间通过 cacheManager 的配置或 SpEL 表达式间接控制。Spring 原生注解不直接支持 TTL 参数，需要结合自定义注解或 @CacheConfig 实现。

3.2.1 原生注解 + CacheManager 组合

@Service
@CacheConfig(cacheNames = "userCache")
public class UserService {

    // 使用 userCache 的 TTL（已在 CacheManager 中配置为 3 秒）
    @Cacheable(key = "#userId")
    public User getUserById(Long userId) {
        // 模拟数据库查询
        return userRepository.findById(userId).orElse(null);
    }

    // 手动清除缓存，确保测试用例读取最新数据
    @CacheEvict(key = "#userId")
    public void evictUserCache(Long userId) {
        // 清除指定用户的缓存
    }
}

3.2.2 自定义注解实现动态 TTL

为了在注解中直接指定过期时间，可以自定义注解并配合 AOP 实现：

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface TestCacheable {
    String cacheName() default "";
    String key() default "";
    long ttlSeconds() default 5;  // 默认 5 秒
}

// AOP 切面实现
@Aspect
@Component
@Profile("test")
public class TestCacheAspect {

    @Autowired
    private StringRedisTemplate redisTemplate;

    @Around("@annotation(testCacheable)")
    public Object around(ProceedingJoinPoint joinPoint, TestCacheable testCacheable) throws Throwable {
        String cacheKey = testCacheable.cacheName() + "::" + testCacheable.key();
        String cachedValue = redisTemplate.opsForValue().get(cacheKey);
        
        if (cachedValue != null) {
            return deserialize(cachedValue);
        }
        
        Object result = joinPoint.proceed();
        redisTemplate.opsForValue().set(cacheKey, serialize(result), 
            testCacheable.ttlSeconds(), TimeUnit.SECONDS);
        return result;
    }
}

3.3 API 动态设置方式

API 动态设置方式允许在测试用例运行时直接操作缓存客户端（如 RedisTemplate、Jedis、Lettuce），实时设置或修改缓存过期时间。这种方式灵活性最高，适合需要精确控制缓存状态的回归冒烟测试。

3.3.1 使用 RedisTemplate 动态设置 TTL

@SpringBootTest
@AutoConfigureMockMvc
public class UserCacheTest {

    @Autowired
    private StringRedisTemplate redisTemplate;

    @Autowired
    private UserService userService;

    private static final String CACHE_KEY = "userCache::1001";

    @Before
    public void setup() {
        // 清除可能存在的旧缓存
        redisTemplate.delete(CACHE_KEY);
    }

    @Test
    public void testCacheExpiration() throws InterruptedException {
        // 1. 调用服务方法，触发缓存写入（默认 TTL 3 秒）
        userService.getUserById(1001L);
        
        // 2. 验证缓存已存在
        assertNotNull(redisTemplate.opsForValue().get(CACHE_KEY));
        
        // 3. 动态修改过期时间为 1 秒（模拟快速过期场景）
        redisTemplate.expire(CACHE_KEY, 1, TimeUnit.SECONDS);
        
        // 4. 等待 1.5 秒，缓存应自动过期
        Thread.sleep(1500);
        
        // 5. 验证缓存已过期
        assertNull(redisTemplate.opsForValue().get(CACHE_KEY));
    }

    @Test
    public void testCacheTTLExtension() {
        // 1. 手动写入缓存，设置过期时间为 2 秒
        redisTemplate.opsForValue().set(CACHE_KEY, "test_value", 2, TimeUnit.SECONDS);
        
        // 2. 在过期前续期（延长到 10 秒）
        redisTemplate.expire(CACHE_KEY, 10, TimeUnit.SECONDS);
        
        // 3. 验证剩余 TTL 大于 8 秒（续期成功）
        Long ttl = redisTemplate.getExpire(CACHE_KEY, TimeUnit.SECONDS);
        assertTrue(ttl > 8);
    }
}

3.3.2 常用 RedisTemplate API 方法

3.4 三种配置方式对比与选择策略

3.5 Testing 环境缓存过期时间配置清单

1. 全局配置： 在 application-test.yml 中设置 spring.cache.redis.time-to-live: 5s
2. 缓存隔离： 使用 test: 前缀区分测试环境缓存，避免与开发环境冲突
3. 注解使用： 在 Service 层方法上使用 @Cacheable，并通过 CacheManager 配置差异化 TTL
4. 测试前置： 在 @Before 方法中通过 @CacheEvict(allEntries = true) 清除相关缓存
5. 动态验证： 使用 RedisTemplate.getExpire() 验证缓存 TTL 是否符合预期
6. 异常场景： 使用 API 方式设置极短 TTL（如 1 秒）模拟缓存过期异常
7. 恢复机制： 在 @After 方法中清理测试过程中动态设置的缓存，避免影响后续测试