connecttimeout必须手动设置，yaml无对应字段；它控制tcp握手超时，默认10秒，docker/k8s环境下需设为15～30秒以防dns慢或网络抖动导致静默失败。
connectTimeout 必须手动设，YAML里没有对应配置项
Spring Boot 的 spring.redis.timeout 不是连接超时，它在 Lettuce 中实际映射为 commandTimeout，只管命令执行阶段。真正控制“TCP 握手失败前等多久”的 connectTimeout，YAML 配置文件里压根没提供字段。
这个值默认是 10 秒，但在 Docker 或 K8s 环境下，DNS 解析慢、网络抖动、哨兵返回内网 IP（比如 10.0.1.5）而客户端在公网时，首次连接就会卡住并直接抛 io.netty.channel.ConnectTimeoutException，根本不会触发重试逻辑。
- 必须通过 Java 配置显式设置：用
LettuceClientConfigurationBuilder或ClientOptions - 推荐值：15s～30s，尤其在容器化部署或跨网络访问哨兵集群时
- 不配的话，哪怕
spring.redis.timeout: 60000调得再大也没用——连接都建不起来，命令根本发不出去
commandTimeout 控制命令级超时，但别和 read-timeout-in-millis 搞混
commandTimeout 是整个命令生命周期上限：从序列化、发包、服务端执行、到反序列化完成的总耗时。Lettuce 默认 60 秒，而 spring.redis.timeout 就是它的 YAML 映射入口，会覆盖默认值。
但如果你手动 new RedisClient 或自定义 ClientResources，还会遇到 read-timeout-in-millis。它属于 Netty Channel 层的单次读阻塞上限，和 commandTimeout 不是同一层：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
read-timeout-in-millis应 ≥commandTimeout，否则可能在命令中途反复触发 Netty 读超时，引发无意义重试甚至雪崩 - 例如设
read-timeout-in-millis=5000但commandTimeout=10000，一个耗时 8 秒的HGETALL可能被中断两次再重发 - Spring Boot 自动配置下你通常接触不到
read-timeout-in-millis，除非绕过自动装配
超时 ≠ 自动重连，重试得靠 RetryTemplate 或连接池保活
Redis 连接超时后，Lettuce 不会自动重连；RedisTemplate 更不会帮你兜底重试。所谓“重连”，本质是业务层捕获异常后重新调用操作方法，或者用 RetryTemplate 包一层。
- 不要在每次
redisTemplate.opsForValue().get(...)前手动 try-catch + sleep + retry，太糙 - 推荐用
RetryTemplate：配SimpleRetryPolicy（比如最多 3 次）+FixedBackOffPolicy（间隔 1 秒），并在@Component里封装成可注入的服务 - 对长连接空闲断连问题（比如 Lettuce 默认不刷新拓扑），需开启自适应拓扑刷新：
ClusterTopologyRefreshOptions.builder().enableAllAdaptiveRefreshTriggers().build()
哨兵集群下 connectTimeout 失败不切换节点，必须显式处理
哨兵模式下，Lettuce 会先连一个哨兵获取主节点地址，但如果连第一个哨兵就超时（比如它返回了不可达的内网 IP），Lettuce 不会自动尝试列表里的下一个哨兵——它直接抛异常，重试逻辑也不生效。
这意味着：仅靠 RetryTemplate 重试命令没用，因为失败发生在初始化连接阶段，不是命令执行阶段。
- 解决办法是预检：启动时主动调用
redisConnectionFactory.getConnection().close()触发连接建立，并捕获ConnectTimeoutException - 更稳妥的是在配置中列出多个哨兵地址（
spring.redis.sentinel.nodes），并确保它们网络可达、IP 可路由 - 若环境受限（如 K8s Service 暴露哨兵为 ClusterIP），建议改用直连 Redis 主从，或在前置加一层 DNS/Service Mesh 解决地址可达性
spring.redis.timeout 后发现还是连不上，就是卡在这一步。
