Java项目应优先使用spring-boot-starter-data-redis（默认Lettuce），避免Jedis线程安全问题；需正确配置连接池、超时及StringRedisSerializer等序列化器，并确保@EnableCaching开启及Bean规范。
Java项目里怎么加Redis依赖
直接在 pom.xml 里加 spring-boot-starter-data-redis 就行，别用老版本的 jedis 单独引入——Spring Boot 2.0+ 默认用 Lettuce，线程安全、支持异步和响应式，Jedis 多线程下得自己管连接池，容易出 Connection reset 或 Cannot get Jedis connection。
推荐写法（Maven）：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
- 如果要用
Jedis（比如兼容旧项目），得排除默认的Lettuce，再显式引入jedis和commons-pool2 -
spring-boot-starter-data-redis不带 Redis 服务，你得单独装 Redis（本地用docker run -p 6379:6379 -d redis最快） - Spring Boot 3.x 要求 JDK 17+，Lettuce 6.x 以上，低版本 JDK 会报
NoClassDefFoundError: io/lettuce/core/Resource
application.yml 怎么配Redis连接
关键不是“填对地址”，而是**连得稳、超时设得合理、序列化别乱配**。默认 JdkSerializationRedisSerializer 会导致存进去一堆 java.util.LinkedHashMap，取出来类型错乱或反序列化失败。
基础配置示例：
立即学习“Java免费学习笔记（深入）”；
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
spring:
redis:
host: localhost
port: 6379
database: 0
timeout: 2000
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 0
max-wait: -1
-
timeout建议设 2000ms 起，太短容易因网络抖动误判失败；设成 0 会阻塞线程 -
max-wait: -1表示无限等待空闲连接，线上建议设具体值（如 1000），避免线程卡死 - 不配
password时别留空字段，否则 Spring 会传空字符串过去，报NOAUTH Authentication required
@Cacheable 注解为啥不生效
不是注解写错了，八成是这三件事没做对：类没被 Spring 管理、缓存没开、序列化器没统一。
- 确保目标类是
@Service或@Component，且调用方也走的是 Spring 代理（不能自己new XxxService()） - 启动类加
@EnableCaching，否则所有@Cacheable静默失效 - 自定义
RedisCacheConfiguration，把 key 和 value 都设成StringRedisSerializer，避免二进制乱码和类型丢失 - 方法返回值要是可序列化类型，
void或Stream不能缓存；参数里别有匿名类、Lambda、不可序列化对象
常见错误日志：Cache put operation skipped due to null value —— 检查方法是否真返回了非 null 结果。
RedisTemplate 手动操作时 key 总对不上
根本原因是 RedisTemplate 默认用 JdkSerializationRedisSerializer，key 存成字节流，CLI 里 KEYS * 看不到明文，GET yourKey 直接报 (error) WRONGTYPE Operation against a key holding the wrong kind of value。
解决办法：初始化时指定字符串序列化器：
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
RedisTemplate<String, Object> template = new RedisTemplate<>();
template.setConnectionFactory(factory);
template.setKeySerializer(new StringRedisSerializer());
template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
return template;
}
-
StringRedisSerializer让 key 可读、可 CLI 操作；GenericJackson2JsonRedisSerializer支持 POJO 自动转 JSON，比JdkSerialization兼容性好 - 别混用不同序列化器的
RedisTemplate实例操作同一个 key，否则读写错乱 - 用
redis-cli调试时，先CONFIG SET notify-keyspace-events KEA开事件通知，再MONITOR抓真实命令，比看代码更准
最常被忽略的一点：本地开发用 localhost，上测试环境忘了改 spring.redis.host，结果缓存全写到自己机器上了，服务看起来正常，但数据根本不进集群。
