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.jpa.hibernate.ddl-auto=update
spring.cache.type=ehcache
spring.cache.ehcache.config=classpath:ehcache.xml

创建 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"/>
    <cache name="productCache" maxEntriesLocalHeap="1000"
           eternal="false" timeToIdleSeconds="60" timeToLiveSeconds="60"
           overflowToDisk="false"/>
</ehcache>

3. 启用缓存

在主启动类上添加 @EnableCaching 注解以激活缓存功能：

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

配置 Caffeine 缓存

如果希望使用更现代的本地缓存实现，可以切换到 Caffeine。它通常比 EhCache 性能更好，且无需额外的 XML 配置。

1. 依赖调整

将 EhCache 依赖替换为 Caffeine：

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

2. 配置变更

修改 application.properties 中的缓存类型及规格：

spring.cache.type=caffeine
spring.cache.caffeine.spec=maximumSize=1000,expireAfterWrite=60s

核心注解详解

Spring Cache 通过三个核心注解管理缓存生命周期，理解它们的差异至关重要。

@Cacheable：读取缓存

标记在查询方法上。首次执行时调用底层方法并将结果存入缓存；后续相同参数请求直接返回缓存值。

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

@CachePut：更新缓存

标记在写入方法上。无论缓存是否存在，都会执行方法并将结果更新到缓存中。常用于更新操作。

@Transactional
@CachePut(value = "productCache", key = "#product.id")
public Product updateProduct(Product product) {
    return productRepository.save(product);
}

@CacheEvict：清除缓存

标记在删除或批量修改方法上。执行后清除指定缓存项，确保数据一致性。

@Transactional
@CacheEvict(value = "productCache", key = "#id")
public void deleteProduct(Long id) {
    productRepository.deleteById(id);
}

实战案例：产品管理接口

结合上述配置，我们可以构建一个完整的产品服务层。注意观察注解如何配合事务管理使用。

@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(readOnly = true)
    @Cacheable(value = "productCache", key = "#id")
    public Product getProductById(Long id) {
        System.out.println("从数据库查询产品：" + id);
        return productRepository.findById(id).orElse(null);
    }

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

运行测试时，你会发现第一次访问特定 ID 会打印日志（触发 DB 查询），第二次则直接从缓存返回，控制台不再输出查询日志。这就是缓存生效的直接证据。

总结

数据缓存是优化 Spring Boot 应用性能的有效途径。通过合理选择 EhCache 或 Caffeine，并结合 @Cacheable、@CachePut 和 @CacheEvict 注解，开发者可以轻松实现读写分离与数据一致性控制。在实际项目中，建议根据数据量级和并发需求选择合适的缓存策略，并注意缓存穿透、击穿等潜在问题的处理。