【Spring全家桶】Spring Cache 深度解析：一行注解实现缓存自动化

一、为什么要使用 Spring Cache？

在传统的缓存开发中（如使用 Redis），我们需要在业务代码中手动编写逻辑：先查询缓存，如果没有再查询数据库，最后把结果放入缓存。这种做法会导致大量重复代码 ，且缓存逻辑与业务逻辑高度耦合。

Spring Cache 通过 AOP（面向切面编程） 技术，将缓存逻辑从业务中剥离出来。你只需要在方法上加上简单的注解，即可实现缓存功能。

二、核心架构与原理

Spring Cache 的核心思想是：在方法执行前检查缓存，执行后更新缓存。

CacheManager：缓存管理器，用于管理各种缓存组件（如 RedisCacheManager, EhCacheManager）。
Cache：缓存接口，定义了缓存的具体操作。

三、快速上手：Spring Boot 整合 Redis 缓存

1. 添加依赖

在 pom.xml 中引入 Redis 缓存启动器：

xml 复制代码

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

2. 开启缓存支持

在 Spring Boot 启动类上添加 @EnableCaching 注解：

java 复制代码

@SpringBootApplication
@EnableCaching // 开启缓存功能
public class CacheApplication {
    public static void main(String[] args) {
        SpringApplication.run(CacheApplication.class, args);
    }
}

3. 在 Service 层使用注解

这是 Spring Cache 最核心的部分，主要使用以下三个注解：

① @Cacheable：触发查询缓存

常用于查询操作。先看缓存有没有，有则直接返回；没有则执行方法并存入缓存。

java 复制代码

@Cacheable(value = "pet", key = "#id")
public PetBean getPetById(Integer id) {
    System.out.println("查询数据库...");
    return petDao.findById(id);
}

② @CachePut：更新缓存

常用于新增或修改操作。方法一定会执行，并将结果同步到缓存中。

java 复制代码

@CachePut(value = "pet", key = "#pet.id")
public PetBean updatePet(PetBean pet) {
    petDao.update(pet);
    return pet;
}

③ @CacheEvict：清除缓存

常用于删除操作。

java 复制代码

@CacheEvict(value = "pet", key = "#id")
public void deletePet(Integer id) {
    petDao.deleteById(id);
}

四、常用注解属性详解

属性	含义	示例
value/cacheNames	缓存名称（相当于 Redis 的前缀）	`value = "user"`
key	缓存的 key，支持 SpEL 表达式	`key = "#user.id"`
condition	满足条件时才缓存	`condition = "#id > 10"`
unless	否定缓存（满足条件时不缓存）	`unless = "#result == null"`

五、避坑指南：Spring Cache 失效的场景

很多初学者会遇到"加了注解但缓存不生效"的问题，通常是以下原因：

内部调用 ：同一个类中，A 方法调用加了缓存注解的 B 方法，缓存会失效。
- 原因：Spring Cache 是基于 AOP 代理的，内部调用不经过代理类。
方法非 public ：缓存注解只能用于 public 方法。
结果未实现序列化 ：如果使用 Redis 存储，存入的对象必须实现 java.io.Serializable 接口。

六、进阶配置：自定义过期时间

默认情况下 Redis 缓存是永久有效的。我们可以通过配置 RedisCacheConfiguration 来设置过期时间：

java 复制代码

@Configuration
public class MyCacheConfig {
    @Bean
    public RedisCacheConfiguration redisCacheConfiguration() {
        return RedisCacheConfiguration.defaultCacheConfig()
                .entryTtl(Duration.ofMinutes(30)) // 设置缓存过期时间 30 分钟
                .disableCachingNullValues();     // 不缓存空值
    }
}

七、总结

Spring Cache 极大地简化了缓存开发，让我们可以专注于业务逻辑。在实际项目中，建议遵循以下原则：

查询多、修改少的数据最适合使用缓存。
一致性要求极高的数据慎用缓存。
合理设置过期时间，防止 Redis 被冷数据撑爆。

下一篇预告：

我们将探讨 Spring Cache 如何配合 Jackson 解决缓存乱码问题 。如果你觉得这篇教程对你有帮助，欢迎 点赞、收藏、关注！

作者： [CodeToGym]

【Spring全家桶】Spring Cache 深度解析：一行注解实现缓存自动化