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 关键配置不能省略
光有依赖不行，连接参数和池化策略要明确写进配置文件，尤其本地开发和生产环境差异大：
- 基础连接：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"。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
