54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# Redis 断连自动重连修复实施计划
|
|
|
|
## 1. 背景
|
|
|
|
后端当前通过 Spring Boot 自动配置的 Lettuce `RedisConnectionFactory` 提供 Redis 连接。现场反馈 Redis 短暂断连或重启后，后端不会恢复可用连接，后续 Redis 访问持续失败。
|
|
|
|
## 2. 问题定位
|
|
|
|
- 项目未自定义 `LettuceConnectionFactory`，使用的是 Spring Boot 默认装配。
|
|
- 默认共享连接在未开启连接校验时，存在继续复用失效连接的风险。
|
|
- 当前 `ruoyi-framework` 仅配置了 `RedisTemplate` 序列化，未对 Lettuce 连接工厂做任何重连相关定制。
|
|
|
|
## 3. 实施方案
|
|
|
|
### 3.1 最短路径修复
|
|
|
|
在 `ruoyi-framework` 的 Redis 配置中增加一个 `BeanPostProcessor`，对 Spring Boot 自动创建的 `LettuceConnectionFactory` 统一开启 `validateConnection`。
|
|
|
|
### 3.2 预期效果
|
|
|
|
- Redis 恢复可用后，连接工厂在获取共享连接时会先校验连接有效性。
|
|
- 避免继续复用已经失效的 Lettuce 共享连接。
|
|
- 不调整现有 `RedisTemplate`、业务缓存调用方式和 YAML 配置结构。
|
|
|
|
## 4. 代码改动点
|
|
|
|
- `ruoyi-framework/src/main/java/com/ruoyi/framework/config/RedisConfig.java`
|
|
- 增加 Lettuce 连接工厂后处理器。
|
|
- 在 Bean 初始化阶段统一开启 `validateConnection`。
|
|
- `ruoyi-framework/src/test/java/com/ruoyi/framework/config/RedisConfigTest.java`
|
|
- 新增回归测试，校验 Lettuce 连接工厂会被强制打开连接校验。
|
|
- `ruoyi-framework/pom.xml`
|
|
- 增加 `spring-boot-starter-test` 测试依赖。
|
|
|
|
## 5. 验证计划
|
|
|
|
执行以下命令验证：
|
|
|
|
```bash
|
|
mvn -pl ruoyi-framework -am test -Dtest=RedisConfigTest -Dsurefire.failIfNoSpecifiedTests=false
|
|
```
|
|
|
|
验证通过标准：
|
|
|
|
- `RedisConfigTest` 通过。
|
|
- `ruoyi-framework` 模块构建成功。
|
|
- 不影响 `ruoyi-common`、`ruoyi-system` 作为依赖模块的测试阶段执行。
|
|
|
|
## 6. 影响范围
|
|
|
|
- 影响模块：`ruoyi-framework`
|
|
- 影响对象：所有通过 Spring 容器注入并复用 `RedisConnectionFactory` / `RedisTemplate` 的后端 Redis 调用
|
|
- 不涉及数据库结构、前端页面、接口入参与返回结构变更
|