当前位置：首页 > news >正文

Spring Boot 集成 Redis中@Cacheable 和 @CachePut 的详细对比，涵盖功能、执行流程、适用场景、参数配置及代码示例

news 2025/7/2 2:33:38

以下是 @Cacheable 和 @CachePut 的详细对比，涵盖功能、执行流程、适用场景、参数配置及代码示例：

1. 核心对比表格

特性	@Cacheable	@CachePut
作用	缓存方法的返回结果，避免重复计算	执行方法并更新缓存，不覆盖原有缓存
执行流程	缓存命中：直接返回缓存值，不执行方法未命中：执行方法，缓存结果	始终执行方法，并将结果更新到缓存
适用场景	查询操作（如`get`方法）	更新操作（如`save`、`update`方法）
缓存行为	覆盖原有缓存值（或按条件更新）	追加或覆盖缓存值（不删除原有数据）
是否执行方法	仅当缓存未命中时执行	始终执行方法
性能影响	最优（减少重复计算）	稍高（需同时执行方法和更新缓存）

2. 详细对比说明

(1) @Cacheable

核心功能：根据方法参数生成缓存键（key），若缓存中存在对应键的值，则直接返回缓存值，否则执行方法并将结果存入缓存。
适用场景：查询操作（如从数据库或远程服务获取数据）。
参数配置：
- value/cacheNames：指定缓存名称（必填）。
- key：自定义缓存键（如#id）。
- condition：条件判断是否缓存（如#result != null）。
- unless：条件判断是否不缓存（如#result == null）。

(2) @CachePut

核心功能：无论缓存是否存在，始终执行方法，并将方法结果更新到缓存中。
适用场景：更新操作（如保存或更新数据后同步更新缓存）。
参数配置：
- value/cacheNames：指定缓存名称（必填）。
- key：自定义缓存键（如#user.id）。
- condition/unless：控制是否更新缓存。

3. 代码示例对比

场景：用户信息的增删改查

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    // @Cacheable：缓存查询结果
    @Cacheable(value = "userCache", key = "#id")
    public User getUserById(Long id) {
        System.out.println("从数据库查询用户ID：" + id);
        return userMapper.selectUserById(id);
    }

    // @CachePut：更新缓存（同时更新数据库）
    @CachePut(value = "userCache", key = "#user.id")
    public User updateUser(User user) {
        System.out.println("更新用户信息并缓存：ID=" + user.getId());
        userMapper.updateUser(user); // 更新数据库
        return user;
    }
}

执行流程对比

方法	@Cacheable流程	@CachePut流程
`getUserById(1)`	1. 检查`userCache:1`是否存在 2. 存在则返回缓存，不执行方法 3. 不存在则执行方法并缓存结果	不适用
`updateUser(user)`	不适用	1. 始终执行方法（更新数据库） 2. 将返回结果存入`userCache:user.id`

4. 关键参数对比

@Cacheable

参数	描述	示例值
`value`	缓存名称（必填）	`"userCache"`
`key`	缓存键（默认`#method.name + #root.args`）	`"user_" + #id`
`condition`	只有满足条件时才缓存结果	`#result != null`
`unless`	满足条件时不缓存结果	`#result.age < 18`

@CachePut

参数	描述	示例值
`value`	缓存名称（必填）	`"userCache"`
`key`	缓存键（默认`#method.name + #root.args`）	`"user_" + #user.id`
`condition`	只有满足条件时才更新缓存	`#user.name != null`

5. 注意事项

组合使用场景：

更新操作：通常需要@CachePut和@CacheEvict的组合，例如：

@CacheEvict(value = "userCache", key = "#id") // 先删除旧缓存
@CachePut(value = "userCache", key = "#user.id") // 再存入新数据
public User updateUser(User user, Long id) { ... }

新增操作：使用@CachePut将新数据存入缓存（如insertUser方法）。

缓存一致性：
- 对于更新操作，需确保数据库和缓存同时更新，避免数据不一致。
- 使用@CacheEvict清除旧缓存，再通过@CachePut存入新数据。
性能权衡：
- @CachePut会强制执行方法，需评估是否影响性能。
- 对于高频写操作，需结合缓存过期策略（如time-to-live）。

6. 总结表格

注解	作用	是否执行方法	适用场景	关键参数
`@Cacheable`	缓存方法结果，减少重复计算	仅当缓存未命中时执行	查询操作（`get`）	`value`, `key`, `condition`
`@CachePut`	更新缓存，确保数据一致性	始终执行方法	更新操作（`update`、`save`）	`value`, `key`, `condition`