以下是 @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. 注意事项

1. 组合使用场景：

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

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

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

2. 缓存一致性：

   • 对于更新操作，需确保数据库和缓存同时更新，避免数据不一致。
   • 使用@CacheEvict清除旧缓存，再通过@CachePut存入新数据。

3. 性能权衡：

   • @CachePut会强制执行方法，需评估是否影响性能。
   • 对于高频写操作，需结合缓存过期策略（如time-to-live）。

---

6. 总结表格

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

通过以上对比，可以清晰理解这两个注解的差异和使用场景，从而在实际开发中合理选择和组合使用。