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):
org.springframework.boot spring-boot-starter-data-redis
- 如果要用
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免费学习笔记(深入)”;
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 RedisTemplateredisTemplate(RedisConnectionFactory factory) { RedisTemplate 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,结果缓存全写到自己机器上了,服务看起来正常,但数据根本不进集群。










