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

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. 验证结果

已执行：

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