Files
ccdi/docs/reports/implementation/2026-04-21-redis断连自动重连修复实施记录.md

42 lines
1.4 KiB
Markdown

# Redis 断连自动重连修复实施记录
## 1. 本次修改内容
-`ruoyi-framework` 的 Redis 配置中新增 Lettuce 连接工厂后处理器。
- 对 Spring Boot 自动装配的 `LettuceConnectionFactory` 统一开启 `validateConnection`
- 新增回归测试,校验连接工厂初始化时已开启连接校验。
-`ruoyi-framework` 补充测试依赖。
## 2. 修改原因
后端 Redis 连接在发生断连后,存在持续复用失效连接的风险,导致 Redis 恢复后应用侧仍无法正常访问缓存。此次修复通过在连接工厂层开启连接校验,缩短恢复路径,避免业务代码层面持续拿到不可用连接。
## 3. 实际变更文件
- `ruoyi-framework/src/main/java/com/ruoyi/framework/config/RedisConfig.java`
- `ruoyi-framework/src/test/java/com/ruoyi/framework/config/RedisConfigTest.java`
- `ruoyi-framework/pom.xml`
## 4. 验证结果
已执行:
```bash
mvn -pl ruoyi-framework -am test -Dtest=RedisConfigTest -Dsurefire.failIfNoSpecifiedTests=false
```
执行结果:
- `BUILD SUCCESS`
- `RedisConfigTest` 通过
## 5. 影响范围
- 后端 Redis 连接恢复行为
- 所有依赖 `RedisTemplate``RedisCache` 的缓存、登录态、验证码、限流等功能
## 6. 备注
- 本次未改动 Redis 地址、密码、库索引、连接池大小等运行参数。
- 本次未引入新的 Redis 客户端,仍保持现有 Spring Data Redis + Lettuce 方案。