修复 Redis 断连重连并更新中介导入文案

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

@@ -0,0 +1,41 @@
+# 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 方案。