spring boot 启动时不报 redis 连接异常，是因为 lettuce 默认启用懒加载，连接延迟至首次调用才初始化；需通过 debug 日志、主动探测或关闭懒加载+协议降级（如设为 resp2）来提前暴露并解决连接问题。
Spring Boot 启动时不报 Redis 连接异常，但 RedisTemplate 注入失败或调用时才抛错
这不是连接“成功”，而是 Spring Boot 默认把 Redis 连接初始化延迟到了第一次使用时（lazy initialization）。Spring Boot 2.3+ 对 LettuceConnectionFactory 启用了懒加载，启动日志里看不到 io.lettuce.core.RedisConnectionException，不代表连得上——它根本没试。
常见表现：
-
@Autowired RedisTemplate成功，但执行opsForValue().get("key")才报RedisConnectionException - 健康检查端点
/actuator/health显示redis: DOWN，但应用照样启动成功 - 日志里没有连接尝试记录，
io.lettuce.core日志级别为 INFO 时完全静默
解决办法：
- 在
application.yml中显式关闭懒加载：spring.redis.lettuce.shutdown-timeout=0不起作用；真正有效的是加配置：spring.redis.jedis.pool.max-active=8（若切 Jedis）或更直接——启用预连接检测 - 添加主动探测逻辑（推荐）：在启动类中注入
RedisConnectionFactory并手动调用getConnection()和close()，捕获异常并提前失败 - 开启 DEBUG 日志看底层数：
logging.level.io.lettuce.core=DEBUG，连接建立、命令发送、协议协商（如HELLO）都会打出来
timeout: 0 导致连接瞬间失败却无提示
Lettuce 客户端把 timeout: 0 解释为“不等待”，即立即断开，不走重试逻辑。它不会抛出典型超时异常，而是静默返回连接不可用状态，后续操作才触发底层异常。
典型配置陷阱：
-
spring.redis.timeout: 0—— 错误，等同于拒绝连接 -
spring.redis.timeout: 3000—— 推荐，3 秒内收不到响应才判定失败 -
spring.redis.lettuce.pool.max-wait: -1—— 连接池获取连接的等待时间，-1 表示无限等待，和timeout是两回事，别混淆
验证方式：改完配置后，用 redis-cli -h ${host} -p ${port} ping 确保服务可达，再观察 Spring Boot 启动时是否出现 Connecting to Redis 类似日志（需 DEBUG 级别）。
Redis 服务端协议不兼容（如 HELLO 命令失败）导致静默认证失败
Spring Boot 2.7+/3.x 默认让 Lettuce 发送 HELLO 命令协商 RESP3 协议。如果你用的是 Redis 3.0.x、4.0.x 或某些 Windows 移植版（如 3.0.504），它们根本不认识 HELLO，会直接返回 ERR unknown command 'HELLO'。Lettuce 遇到这个错误后，**不会 fallback 到 AUTH + PING 流程**，而是继续发 PING，结果被服务端拒之门外，报 NOAUTH Authentication required —— 但这个错误只在第一次调用时暴露，启动阶段毫无痕迹。
关键证据在 DEBUG 日志里：
io.lettuce.core.protocol.CommandHandler : Completing command AsyncCommand [type=HELLO error='ERR unknown command 'HELLO''] io.lettuce.core.protocol.CommandHandler : Completing command AsyncCommand [type=PING error='NOAUTH Authentication required.']
解决方案只有两个：
- 升级 Redis 到 6.0+（支持 RESP3）
- 降级客户端协议：在
application.yml中添加spring.redis.lettuce.client-options.protocol-version=RESP2（Spring Boot 2.7+ 支持）或通过 Java Config 强制指定ClientOptions.builder().protocolVersion(ProtocolVersion.RESP2)
密码正确但连接始终失败，且无明确认证错误提示
现象是 redis-cli -a xxx ping 能通，但 Spring Boot 死活报 NOAUTH。除了上面协议问题，另一个隐蔽原因是 YAML 缩进或特殊字符未转义。
例如：
-
password: my@pass#123——#被 YAML 解析为注释，实际传给 Lettuce 的是空密码 -
password: "my@pass#123"—— 加双引号才安全 -
password: ${REDIS_PASSWORD}—— 环境变量未设置，值为空，但配置解析不报错 - Windows 上用记事本编辑 YAML，BOM 头导致
password字段开头有不可见字符
最稳的验证方式：写个单元测试，手动构造 RedisStandaloneConfiguration，调用 setPassword(RedisPassword.of("xxx"))，再用 getConnection() 尝试握手——绕过所有自动配置干扰。
真正难排查的从来不是“连不上”，而是“看起来连上了，其实没连”。协议协商、懒加载、YAML 解析、服务端保护模式这些环节，任何一个卡住都不会在启动时亮红灯。动手前先开 logging.level.io.lettuce.core=DEBUG，否则你只是在猜。
