Spring Boot集成Redis核心是配得准、存得对、用得稳:必须同时引入spring-boot-starter-data-redis、spring-boot-starter-cache和commons-pool2依赖,配置host/port/password/database、timeout及Lettuce连接池参数,并统一使用String+JSON序列化,配合@Cacheable等注解实现零侵入缓存逻辑。

Spring Boot 集成 Redis 实现业务数据快速缓存,核心是“配得准、存得对、用得稳”。不需要写一堆底层连接代码,靠官方 Starter 就能起步,但跳过关键配置容易导致乱码、超时、连接耗尽或缓存不一致。
基础依赖与连接池必须一起加
只加 spring-boot-starter-data-redis 不够,它默认用 Lettuce 客户端,但不带连接池——高并发下会频繁创建销毁连接,拖慢性能甚至失败。必须显式引入连接池依赖:
org.springframework.boot:spring-boot-starter-data-redis-
org.springframework.boot:spring-boot-starter-cache(启用 @Cacheable 等注解) -
org.apache.commons:commons-pool2(Lettuce 连接池必需)
不用手动排除 Jedis,Lettuce 是 Spring Boot 2.0+ 默认且推荐的客户端,线程安全、资源占用低。
application.yml 关键配置不能省略
光有依赖不行,连接参数和池化策略要明确写进配置文件,尤其本地开发和生产环境差异大:
立即学习“Java免费学习笔记(深入)”;
- 基础连接:host、port、password(无密码可不填)、database(建议固定用 0 或 1,别混用)
- 超时控制:timeout 设为 3000ms 左右,避免网络抖动卡死线程
-
Lettuce 连接池(重点!):
-
max-active: 50(最大连接数,压测后调优,初始可设 20~50) -
max-idle: 10、min-idle: 2(空闲连接上下限,防资源闲置又保响应速度) -
max-wait: 1000(获取连接最长等待毫秒,超时抛异常,比无限阻塞更可控)
-
序列化方式决定缓存是否可读、是否兼容
默认 JDK 序列化会产生不可读二进制,还容易因类结构变更反序列化失败。推荐统一用 JSON:
- key 始终用 String 序列化(Redis key 必须是字符串)
- value 用
GenericJackson2JsonRedisSerializer,支持泛型、字段忽略、日期格式化 - 在 RedisConfig 中配置 RedisTemplate 的 keySerializer 和 valueSerializer,StringRedisTemplate 仅用于纯字符串场景
这样存进去的是标准 JSON 字符串,Redis CLI 里 GET key 能直接看清内容,调试和排查问题省一半力气。
@Cacheable 注解让缓存逻辑零侵入
对查询方法加一行注解,就自动完成「查缓存 → 查库 → 写缓存」流程:
-
@Cacheable(value = "user", key = "#id"):以参数 id 为 key 缓存返回对象 -
@CacheEvict(value = "user", key = "#user.id"):更新或删除用户后主动清缓存 - 搭配
@EnableCaching开启缓存抽象,无需改 Service 层原有逻辑
注意:被注解的方法需是 public,且所在类由 Spring 容器管理;复杂 key 可用 SpEL 表达式,比如 key = "#user.id + '_' + #user.type"。


















