Spring @CachePut 响应意外问题解析

基础概念

@CachePut 是 Spring 框架提供的缓存注解之一，用于将方法返回值放入缓存中。与 @Cacheable 不同，@CachePut 总是会执行方法体，并将结果存入缓存。

常见意外响应及原因

1. 缓存未更新

现象：调用 @CachePut 方法后，缓存看起来没有更新。

原因：

缓存键生成策略不正确，导致新值与旧值使用了不同的键
缓存管理器配置错误
方法返回值可能为 null，而某些缓存实现不会缓存 null 值

解决方案：

@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    // 确保返回非null值
    return userRepository.save(user);
}

2. 缓存与数据库不一致

现象：缓存已更新，但数据库查询仍返回旧值。

原因：

方法内部事务未提交
缓存更新发生在事务提交之前

解决方案：

@Transactional
@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    // 确保事务提交
    return userRepository.save(user);
}

3. 缓存类型不匹配

现象：缓存的值类型与预期不符。

原因：

序列化/反序列化配置不当
使用了错误的缓存实现

解决方案：检查缓存配置，确保序列化器正确配置：

@Bean
public CacheManager cacheManager() {
    return new ConcurrentMapCacheManager("users") {
        @Override
        protected Cache createConcurrentMapCache(String name) {
            return new ConcurrentMapCache(name,
                CacheConfigurationBuilder.newCacheConfigurationBuilder(
                    Object.class, Object.class,
                    ResourcePoolsBuilder.heap(100))
                .withSerializer(new Jackson2JsonSerializer())
                .build(), true);
        }
    };
}

最佳实践

明确指定缓存键：避免使用默认键生成策略
处理null值：考虑是否要缓存null结果
事务一致性：注意事务边界与缓存操作的顺序
缓存失效策略：考虑设置适当的TTL

调试技巧

启用Spring缓存调试日志：

logging.level.org.springframework.cache=DEBUG

检查缓存键生成：

@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    System.out.println("Cache key will be: " + user.getId());
    return userRepository.save(user);
}

通过以上分析和解决方案，应该能够解决大多数 @CachePut 相关的意外响应问题。