Spring Boot 数据缓存集成与性能优化实战

2. 配置文件

在 application.properties 中指定缓存类型为 ehcache，并指向 XML 配置文件路径。

# 服务器端口
server.port=8080
# 数据库连接信息
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
# JPA 配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
# H2 数据库控制台
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
# EhCache 配置
spring.cache.type=ehcache
spring.cache.ehcache.config=classpath:ehcache.xml

同时创建 src/main/resources/ehcache.xml 定义缓存策略，例如限制堆内最大条目数和过期时间。

<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd">
    <defaultCache maxEntriesLocalHeap="10000" eternal="false"
                  timeToIdleSeconds="120" timeToLiveSeconds="120"
                  overflowToDisk="false" diskPersistent="false"/>
    <cache name="productCache" maxEntriesLocalHeap="1000"
           eternal="false" timeToIdleSeconds="60" timeToLiveSeconds="60"
           overflowToDisk="false" diskPersistent="false"/>
</ehcache>

3. 代码实现

启动类上必须加上 @EnableCaching 注解开启缓存功能。业务层通过 @Cacheable、@CachePut 和 @CacheEvict 来管理缓存生命周期。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cache.annotation.*;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;

    // 新增或更新时写入缓存
    @Transactional
    @CachePut(value = "productCache", key = "#product.id")
    public Product addProduct(Product product) {
        return productRepository.save(product);
    }

    // 删除时清除缓存
    @Transactional
    @CacheEvict(value = "productCache", key = "#id")
    public void deleteProduct(Long id) {
        productRepository.deleteById(id);
    }

    // 查询时优先读缓存
    @Transactional(readOnly = true)
    @Cacheable(value = "productCache", key = "#id")
    public Product getProductById(Long id) {
        System.out.println("从数据库查询产品：" + id);
        return productRepository.findById(id).orElse(null);
    }
}

配置 Caffeine 缓存

Caffeine 是基于 Guava Cache 改进的高性能本地缓存库，默认配置比 EhCache 更简洁，适合对性能要求较高的场景。

1. 依赖调整

将 EhCache 依赖替换为 Caffeine 依赖即可。

<dependency>
    <groupId>com.github.ben-manes.caffeine</groupId>
    <artifactId>caffeine</artifactId>
</dependency>

2. 配置变更

在 application.properties 中切换类型，并使用 spec 参数直接定义缓存规格（最大容量、过期策略）。

# Caffeine 缓存配置
spring.cache.type=caffeine
spring.cache.caffeine.spec=maximumSize=1000,expireAfterWrite=60s

这种方式省去了编写 XML 文件的麻烦，配置更加直观。业务代码逻辑保持不变，依然使用相同的缓存注解。

核心注解详解

Spring Boot 的缓存机制主要通过三个注解协同工作，理解它们的区别至关重要。

@Cacheable

这是最常用的注解，用于标记方法。当调用该方法时，Spring 会先检查缓存中是否存在对应 key 的数据。如果存在，直接返回；如果不存在，才执行方法体并将结果存入缓存。

注意：该注解通常只用于读操作（GET），因为它不会触发写操作。

@CachePut

无论缓存中是否有数据，该方法都会被执行，且执行结果会被更新到缓存中。这常用于更新操作（PUT），确保缓存与数据库保持一致。

场景：当你修改了实体对象后，需要立即刷新缓存中的旧数据。

@CacheEvict

用于清除缓存中的数据。通常在删除操作（DELETE）或批量更新后使用，防止脏数据长期驻留缓存。

关键点：key 属性决定了清除哪条缓存记录，务必与查询时的 key 生成规则一致。

实际应用场景与总结

在实际项目中，缓存策略的选择取决于数据一致性要求和并发场景。例如，商品信息变动不频繁，适合长时间缓存；而订单状态可能实时变化，缓存时间应设短或采用失效策略。

一个简单的测试验证流程如下：首次访问接口打印'从数据库查询'，再次访问同一 ID 则不再打印日志，说明命中了缓存。这种机制能显著降低数据库 IO 压力。

本章我们梳理了 Spring Boot 数据缓存的核心概念、EhCache 与 Caffeine 的集成差异，以及三大注解的实际用法。掌握这些内容，你就能在开发中从容应对性能瓶颈问题。后续章节我们将继续探索 Spring Boot 的其他组件与微服务架构。