# 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 方案。
