Redis连接异常需三层递进排查：①验证Redis服务是否就绪（redis-cli ping返回PONG）；②检查protected-mode、bind配置及密码；③核对Lettuce协议版本（如RESP2/RESP3兼容性）与配置前缀（spring.data.redis）。
Redis 连接异常在 Spring Boot 中通常表现为 RedisConnectionException、RedisConnectionFailureException 或 RedisCommandTimeoutException。这类异常不是代码逻辑错误，而是连接链路某处中断的信号——得从服务端、网络、客户端配置三层递进排查，而不是一上来就改超时或重试。
确认 Redis 服务本身是否就绪
这是最容易被跳过的一步，但 70% 的问题卡在这里：
- 执行
redis-cli ping，返回 PONG 才算通；若报Connection refused，说明 Redis 进程没运行，或监听地址/端口不匹配 - Linux 下用
ps -ef | grep redis查进程；Windows 下确认redis-server.exe是双击启动了，不是只解压完 - 检查
application.yml中的spring.data.redis.host和port是否与你实际启动 Redis 的地址一致（比如 Redis 改为 6380，但配置仍写 6379）
检查 protected-mode 和 bind 配置
Redis 3.2+ 默认开启保护模式，只允许本地回环连接。一旦应用部署在 Docker、远程服务器或云主机上，就会被拒绝：
- 编辑
redis.conf，注释掉bind 127.0.0.1（即加#），或改为bind 0.0.0.0 - 将
protected-mode yes改为protected-mode no；或者更安全的做法是启用密码：requirepass yourpassword，并在配置中补上spring.data.redis.password: yourpassword - 改完必须重启 Redis：
redis-cli shutdown后再redis-server /path/to/redis.conf，仅 reload 不生效
核对 Lettuce 客户端配置是否生效
Spring Boot 3.x 起，Redis 配置前缀已统一为 spring.data.redis，旧写法会被忽略：
- 连接池参数必须写成
spring.data.redis.lettuce.pool.max-active，而非spring.redis.lettuce.pool.max-active - 若 Redis 是 5.0 或更早版本，Lettuce 6.x 默认用 RESP3 协议，会握手失败；需强制降级：
spring.data.redis.lettuce.client-options.protocol-version=RESP2 - 确保未显式引入
jedis依赖——它会与 Lettuce 冲突，导致连接池初始化失败
补充容错与可观测性手段
生产环境不能只靠“连不上就报错”，还需主动兜底和监控：
- 对
@Cacheable场景，实现CacheErrorHandler，捕获连接异常后自动 fallback 到原方法，避免雪崩 - 开启 Lettuce 心跳检测（如配置
client-options.ping-before-activate-connection=true），避免连接空闲超时断开 - 加日志级别：
logging.level.org.springframework.data.redis=DEBUG，可看清连接建立、认证、协议协商全过程
