@Cacheable、@CachePut和@CacheEvict三個注解的使用及區(qū)別

更新時間：2026年05月21日 10:07:07 作者：dushky

@Cacheable、@CachePut和@CacheEvict是Spring框架中的核心緩存注解,分別用于查詢、更新和刪除緩存操作,@Cacheable在緩存命中時跳過方法執(zhí)行；@CachePut強制執(zhí)行并更新緩存；@CacheEvict刪除或清空緩存,注意事項包括鍵的一致性、事務處理和條件過濾等

@Cacheable

作用：

在方法執(zhí)行前檢查緩存，如果緩存中存在對應結(jié)果，直接返回緩存值，跳過方法執(zhí)行；若不存在，則執(zhí)行方法并將返回值存入緩存。

適用場景：

查詢操作（例如根據(jù) ID 查詢用戶信息）。
適用于結(jié)果穩(wěn)定、不頻繁變更的數(shù)據(jù)。

關(guān)鍵參數(shù)：

value/cacheNames：緩存名稱（如 "users"）。
key：緩存的鍵（支持 SpEL 表達式）。
condition/unless：緩存條件（如 condition="#id > 10"）。

示例：

@Cacheable(value = "users", key = "#id")
public User getUserById(Long id) {
    // 查詢數(shù)據(jù)庫
    return userRepository.findById(id);
}

@CachePut

作用：

無論緩存是否存在，始終執(zhí)行方法，并將返回值更新到緩存中。適用于需要強制刷新緩存的場景。

適用場景：

更新操作（例如修改用戶信息后同步更新緩存）。
需要確保緩存與數(shù)據(jù)庫數(shù)據(jù)一致。

關(guān)鍵參數(shù)：

與 @Cacheable 相同，但需確保 key 的生成邏輯與 @Cacheable 一致，否則可能導致緩存不一致。

示例：

@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    // 更新數(shù)據(jù)庫
    userRepository.update(user);
    return user; // 更新后的結(jié)果存入緩存
}

@CacheEvict

作用：

刪除指定緩存條目或清空整個緩存。支持在方法調(diào)用前或后觸發(fā)。

適用場景：

刪除操作（例如刪除用戶后清除緩存）。
數(shù)據(jù)變更后需要清理舊緩存（如批量更新后清空列表緩存）。

關(guān)鍵參數(shù)：

allEntries：是否清空整個緩存（默認為 false，僅刪除 key 對應的條目）。
beforeInvocation：是否在方法執(zhí)行前刪除緩存（默認為 false，方法執(zhí)行后刪除）。

示例：

@CacheEvict(value = "users", key = "#id")
public void deleteUser(Long id) {
    userRepository.deleteById(id);
}

// 清空整個緩存
@CacheEvict(value = "users", allEntries = true)
public void refreshAllUsers() {
    // 無需實際邏輯，僅觸發(fā)緩存清理
}

三者的核心區(qū)別

注解	是否執(zhí)行方法體	緩存行為	典型場景
@Cacheable	緩存命中時跳過	讀取緩存或?qū)懭胄陆Y(jié)果	查詢（冪等操作）
@CachePut	始終執(zhí)行	強制更新緩存	更新（非冪等）
@CacheEvict	通常執(zhí)行	刪除緩存條目或清空整個緩存	刪除或清理緩存