SYSTEM
改造全流程:Redis & Redisson 冲突问题
src/content/notes/blog-dev/改造全流程:Redis-&-Redisson-冲突问题.md 二、改造全流程:Redis & Redisson 冲突问题
问题 1:IDE 编译红线 GenericJackson2JsonRedisSerializer 构造器报错
现象
IDE 提示:应为无参构造,但代码传入 ObjectMapper 实参,标红。
根因
- SB 3.5.4 中
GenericJackson2JsonRedisSerializer支持 ObjectMapper 入参构造,代码本身正确; - 降级后未执行 Maven Reimport,IDEA 本地依赖索引缓存未刷新,静态检查误报。
解决方案
- Maven 侧边栏刷新全部依赖,执行
mvn clean compile(命令行无报错即证明代码合法); - IDEA 清除缓存:File → Invalidate Caches → 重启 IDE;
- 兜底:删除
.m2/repository对应 Jackson、spring-data-redis 目录,重新下载。
问题 2:运行启动报错 Redis AUTH 空密码拒绝连接
现象
启动日志:ERR AUTH <password> ... no password configured,本地 Docker Redis 未设密码。
根因
应用程序配置 password:[已隐藏] 在无环境变量时解析为空字符串 ""`,Redisson/Redis 客户端将空字符串当作有效密码发送 AUTH 指令,本地无密码 Redis 拒绝。
解决方案
密码配置默认值设为 null 而非空字符串:
spring:
data:
redis:
password:[已隐藏]
#{null} 是 SpEL 表达式,解析为 Java null,客户端判断 null 时跳过 AUTH。
问题 3:手动 RedissonClient Bean 与 Starter 自动配置冲突
现象
RedisConfig.java 中手动创建了 RedissonClient Bean,同时 pom.xml 引入了 redisson-spring-boot-starter。两者产生重复的 RedissonClient Bean 定义,且手动 Bean 绕过了 Starter 对 spring.data.redis.* 配置的自动读取。
根因
这是 SB 4.x 遗留的临时 hack。SB 4.x 将 RedisProperties 重命名为 DataRedisProperties,导致 Redisson 3.31.0 的 RedissonAutoConfigurationV2 引用旧类失败,当时只能手动创建。但 SB 3.5.4 中 RedisProperties 未改名,Starter 自动配置完全正常。
解决方案
删除 RedisConfig.java 中的 redissonClient() 方法及相关 @Value 字段,让 redisson-spring-boot-starter 自动装配。RedisUtil 通过构造器注入自动获取 RedissonClient。
问题 4:deleteByPattern 使用底层连接,存在 NPE 风险
现象
RedisUtil.java 中:
try (Cursor<byte[]> cursor = redisTemplate.getConnectionFactory().getConnection()
.scan(options)) {
getConnectionFactory() 可能返回 null,getConnection() 直接操作底层连接,绕过了 RedisTemplate 的序列化机制。
解决方案
改用 redisTemplate.scan():
try (Cursor<String> cursor = redisTemplate.scan(options)) {
while (cursor.hasNext()) {
redisTemplate.delete(cursor.next());
}
}
redisTemplate.scan() 返回 Cursor<String>(key 用 StringRedisSerializer 序列化),无需手动 new String() 转换。