?? 前言

在高并發(fā)、高性能的系統(tǒng)開(kāi)發(fā)中，緩存是提升接口響應(yīng)速度和降低數(shù)據(jù)庫(kù)壓力的重要手段。Spring Boot 提供了強(qiáng)大的緩存抽象層 —— spring-context-support，并結(jié)合 JSR-107 標(biāo)準(zhǔn)，提供了多個(gè)緩存注解，如：

• @Cacheable
• @CachePut
• @CacheEvict

這些注解可以讓我們?cè)诓磺秩霕I(yè)務(wù)邏輯的前提下，輕松實(shí)現(xiàn)方法級(jí)別的緩存管理。

本文將帶你從零開(kāi)始掌握 Spring Boot 中常用的緩存注解，并通過(guò)多個(gè)實(shí)際案例演示其強(qiáng)大功能，包括：

• 查詢緩存優(yōu)化
• 數(shù)據(jù)更新同步
• 刪除緩存策略
• 多級(jí)緩存架構(gòu)設(shè)計(jì)
• Redis 實(shí)戰(zhàn)整合
• 緩存穿透、擊穿、雪崩的解決方案

無(wú)論你是初學(xué)者，還是有一定經(jīng)驗(yàn)的開(kāi)發(fā)者，這篇文章都能讓你快速上手 Spring Boot 緩存機(jī)制！

?? 一、Spring Boot 緩存核心機(jī)制概述

? 緩存抽象原理

Spring 的緩存機(jī)制基于 AOP 實(shí)現(xiàn)，本質(zhì)上是在方法執(zhí)行前后插入緩存邏輯：

?? 注意：

• 這些注解只能用在 public 方法上；
• 只有當(dāng)調(diào)用方通過(guò) Spring 代理調(diào)用該方法時(shí)才生效（即不能在同一個(gè)類中直接調(diào)用帶注解的方法）；
• 需要啟用緩存功能：@EnableCaching

??? 二、快速入門：開(kāi)啟緩存支持

Step 1：添加依賴（以 Redis 為例）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

也可以使用本地緩存如 Caffeine 或 Ehcache。

Step 2：?jiǎn)⒂镁彺?/h3>

@SpringBootApplication
@EnableCaching
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

?? 三、三大緩存注解詳解與實(shí)戰(zhàn)

? 1. @Cacheable：查詢緩存，避免重復(fù)計(jì)算

場(chǎng)景說(shuō)明：

當(dāng)你有一個(gè)查詢接口，數(shù)據(jù)變更頻率低，但查詢頻繁，就可以使用 @Cacheable 來(lái)緩存結(jié)果。

示例代碼：

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    @Cacheable(value = "users", key = "#userId")
    public User getUserById(Long userId) {
        System.out.println("【真實(shí)查詢】用戶ID：" + userId);
        return userRepository.findById(userId).orElse(null);
    }
}

參數(shù)說(shuō)明：

• value / cacheNames：指定緩存名稱，可理解為緩存區(qū)域；
• key：緩存鍵，默認(rèn)使用參數(shù)生成；
• unless：條件判斷，例如 unless = "#result == null" 表示結(jié)果為空時(shí)不緩存；
• condition：根據(jù)條件決定是否緩存，例如 condition = "#userId > 0"。

? 2. @CachePut：更新緩存，保持一致性

場(chǎng)景說(shuō)明：

當(dāng)你對(duì)數(shù)據(jù)進(jìn)行了更新或新增操作，需要同步更新緩存，保證下次查詢拿到的是最新數(shù)據(jù)。

示例代碼：

@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    return userRepository.save(user);
}

?? 注意：

• @CachePut 總是會(huì)執(zhí)行方法體，并將結(jié)果放入緩存；
• 常用于新增、修改等寫操作。

? 3. @CacheEvict：清除緩存，強(qiáng)制刷新

場(chǎng)景說(shuō)明：

當(dāng)你刪除某個(gè)數(shù)據(jù)或批量清空緩存時(shí)，就需要使用 @CacheEvict。

示例代碼：

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

清空整個(gè)緩存區(qū)：

@CacheEvict(value = "users", allEntries = true)
public void clearAllUsers() {
    // 刪除所有用戶邏輯
}

?? 參數(shù)說(shuō)明：

• allEntries = true：清空該緩存區(qū)域下的所有鍵；
• beforeInvocation = true：是否在方法執(zhí)行前清空緩存（默認(rèn) false，在方法執(zhí)行后）。

?? 四、進(jìn)階技巧與最佳實(shí)踐

? 1. 自定義緩存 Key 生成策略

可以通過(guò)實(shí)現(xiàn) KeyGenerator 接口自定義緩存 key 的生成方式：

@Bean
public KeyGenerator customKeyGenerator() {
    return (target, method, params) -> {
        StringBuilder sb = new StringBuilder();
        sb.append(target.getClass().getSimpleName());
        sb.append(method.getName());
        for (Object obj : params) {
            sb.append(obj.toString());
        }
        return sb.toString();
    };
}

然后在注解中使用：

@Cacheable(value = "users", keyGenerator = "customKeyGenerator")

? 2. 設(shè)置緩存過(guò)期時(shí)間（以 Redis 為例）

在 application.yml 中配置：

spring:
  redis:
    timeout: 60s
  cache:
    redis:
      time-to-live: 3600000 # 1小時(shí)

? 3. 多級(jí)緩存策略（Redis + Caffeine）

為了進(jìn)一步提升性能，可以采用“本地緩存 + 分布式緩存”的組合方案：

• 使用 Caffeine 作為本地緩存，減少網(wǎng)絡(luò)開(kāi)銷；
• 使用 Redis 作為分布式緩存，確保多節(jié)點(diǎn)間數(shù)據(jù)一致。

示例配置：

@Configuration
public class CacheConfig {
    @Bean
    public CacheManager caffeineCacheManager() {
        CaffeineCacheManager cacheManager = new CaffeineCacheManager("localUsers");
        cacheManager.setCacheBuilder(Caffeine.newBuilder().expireAfterWrite(5, TimeUnit.MINUTES));
        return cacheManager;
    }
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        template.afterPropertiesSet();
        return template;
    }
}

? 4. 緩存穿透、擊穿、雪崩解決方案

示例：防止緩存穿透

@Cacheable(value = "products", key = "#productId", unless = "#result == null")
public Product getProductById(Long productId) {
    Product product = productRepository.findById(productId).orElse(null);
    if (product == null) {
        // 緩存空值，防止緩存穿透
        redisService.setWithExpire("product:" + productId, "", 60, TimeUnit.SECONDS);
    }
    return product;
}

?? 五、綜合案例：商品信息緩存實(shí)戰(zhàn)

背景：

我們有一個(gè)商品服務(wù)，包含如下功能：

• 查詢商品詳情（緩存）
• 更新商品信息（更新緩存）
• 刪除商品（清除緩存）

代碼示例：

@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;
    @Cacheable(value = "products", key = "#productId")
    public Product getProductById(Long productId) {
        return productRepository.findById(productId).orElse(null);
    }
    @CachePut(value = "products", key = "#product.id")
    public Product updateProduct(Product product) {
        return productRepository.save(product);
    }
    @CacheEvict(value = "products", key = "#productId")
    public void deleteProduct(Long productId) {
        productRepository.deleteById(productId);
    }
}

?? 六、常見(jiàn)問(wèn)題與解決方案

?? 七、總結(jié)對(duì)比表

?? 八、結(jié)語(yǔ)

Spring Boot 的緩存注解為我們提供了一種聲明式的緩存管理方式，極大地提升了開(kāi)發(fā)效率和系統(tǒng)性能。無(wú)論是構(gòu)建企業(yè)級(jí)后臺(tái)系統(tǒng)，還是搭建高并發(fā) API 平臺(tái)，都應(yīng)該合理使用緩存來(lái)優(yōu)化系統(tǒng)表現(xiàn)。

通過(guò)本文的學(xué)習(xí)，你已經(jīng)掌握了：

• 如何使用 @Cacheable、@CachePut、@CacheEvict；
• 如何結(jié)合 Redis 或本地緩存進(jìn)行實(shí)際應(yīng)用；
• 如何避免緩存穿透、雪崩、擊穿等問(wèn)題；
• 如何提高系統(tǒng)的響應(yīng)速度和穩(wěn)定性。

到此這篇關(guān)于Spring Boot 緩存注解詳解：@Cacheable、@CachePut、@CacheEvict（超詳細(xì)實(shí)戰(zhàn)版）的文章就介紹到這了,更多相關(guān)Spring Boot @Cacheable、@CachePut、@CacheEvict內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！