快捷導(dǎo)航

Spring全家桶中@CacheEvict無效情況的問題解決

更新時(shí)間：2025年10月27日 10:25:04 作者：No8g攻城獅

本文主要介紹了SpringBoot中@CacheEvict注解刪除緩存無效的情況,主要包括Controller直接調(diào)用、key值不匹配、方法組織、返回值類型和代理機(jī)制,具有一定的參考價(jià)值,感興趣的可以了解一下

一、背景介紹

SpringBoot中使用@Cacheable注解緩存數(shù)據(jù)，使用@CacheEvict注解刪除緩存。但是在項(xiàng)目使用過程中，發(fā)現(xiàn)使用@CacheEvict注解刪除緩存無效。

拓展：@CacheEvict 就是一個(gè)觸發(fā)器，在每次調(diào)用被它注解的方法時(shí)，就會(huì)觸發(fā)刪除它指定的緩存的動(dòng)作。跟 @Cacheable 和 @CachePut 一樣，@CacheEvict 也要求指定一個(gè)或多個(gè)緩存，也指定自定義的緩存解析器和 key 生成器，也支持指定條件（condition 參數(shù)）。

@CacheEvict 是用來清除緩存的，有以下屬性：
value：緩存位置名稱，不能為空。
key：緩存的key，默認(rèn)為空。
condition：觸發(fā)條件，只有滿足條件的情況才會(huì)清除緩存，默認(rèn)為空，支持SpEL。
allEntries：true表示清除value中的全部緩存，默認(rèn)為false。

二、原因分析

經(jīng)過網(wǎng)絡(luò)搜索與總結(jié)，Spring全家桶中@CacheEvict無效的原因有以下幾種情況：

1、使用@CacheEvict注解的方法必須是Controller層直接調(diào)用，Service里間接調(diào)用不生效。（我本次出現(xiàn)無效的原因）
2、key值跟你查詢方法的key值不統(tǒng)一，所以導(dǎo)致緩存并沒有清除。
3、把@CacheEvict的方法和@Cacheable的方法放到一個(gè)java文件中寫，如果這兩個(gè)注解在兩個(gè)java文件的話，會(huì)導(dǎo)致@CacheEvict失效。
4、返回值必須設(shè)置為void才會(huì)生效。網(wǎng)絡(luò)上有很多同學(xué)有返回值的使用@CacheEvict這個(gè)注解也是無效的。

@CacheEvict annotation
It is important to note that void methods can be used with @CacheEvict

5、@CacheEvict必須作用在走代理的方法上。同原因1。

在使用Spring @CacheEvict注解的時(shí)候，要注意，如果類A的方法function1()被標(biāo)注了 @CacheEvict注解，那么當(dāng)類A的其他方法，例如：function2()，去直接調(diào)用function1()的時(shí)候， @CacheEvict是不起作用的，原因是 @CacheEvict是基于Spring AOP代理類，function2()屬于內(nèi)部方法，直接調(diào)用function1()時(shí)，是不走代理的。

@CacheEvict不生效的代碼示例如下：