Unable to connect to Redis; nested exception is io.lettuce.core.RedisConnectionException: Unable to connect to localhost:6309] with root cause

### Redis 连接异常解决方案 当遇到 `io.lettuce.core.RedisConnectionException` 异常时，通常表示客户端无法成功连接到指定的 Redis 实例。以下是可能导致此问题的原因以及对应的解决方法： #### 1. **端口未开放** 如果 Redis 服务运行在特定端口上（如本例中的 6309），而该端口未被监听或防火墙阻止，则会引发连接失败。需确认目标主机上的 Redis 是否正在监听指定端口并允许外部访问[^1]。 可以通过以下命令验证 Redis 的状态和服务配置： ```bash netstat -tuln | grep 6309 ``` 如果没有看到对应条目，说明 Redis 可能未启动或者绑定地址错误。此时应检查 Redis 配置文件 `/etc/redis.conf` 中 bind 参数设置是否正确，并重启服务生效。 #### 2. **IP 地址不匹配** 默认情况下，某些 Redis 安装仅接受来自本地回环接口 (localhost 或 127.0.0.1) 的请求。如果尝试通过其他 IP 访问则会被拒绝。调整 redis.conf 文件内的 bind 行可以更改这一行为[^2]。 例如修改为如下内容以支持任意网络适配器接入： ```conf bind 0.0.0.0 ``` 注意执行上述操作前务必考虑安全性影响！ #### 3. **密码认证失败** Lettuce 库作为 Java 下主流之一用于实现 Redis 操作，在建立链接过程中可能涉及身份校验环节。假如服务器启用了 ACL 功能却未能提供合法凭证也会抛出此类异常消息[^3]。 因此建议先测试无参直连情形；一旦发现需要鉴权再补充相应参数至初始化选项里去比如这样子： ```java RedisURI redisUri = RedisURI.builder() .withHost("localhost") .withPort(6309) .withPassword("your_redis_password") // 如果有密码保护的话 .build(); StatefulRedisConnection<String, String> connection = RedisClient.create(redisUri).connect(); ``` #### 4. **超时设定不足** 长时间等待响应也可能触发 timeout 错误进而表现为 connection exception 。适当延长 client-side 超时期限有助于缓解因网络延迟等原因造成的短暂不可达状况[^4]。 示例代码展示如何自定义 Lettuce ClientOptions 来增加读写时间窗口大小： ```java import io.lettuce.core.ClientOptions; ... ClientOptions options = ClientOptions.builder() .disconnectedBehavior(ClientOptions.DisconnectedBehavior.REJECT_COMMANDS) .timeoutOptions( TimeoutOptions.timeoutOptions().fixedTimeout(Duration.ofSeconds(10))) .build(); RedisClient client = RedisClient.create(RedisURI.Builder.redis("localhost", 6309).build()); client.setOptions(options); ``` 以上即针对所提现象给出的一些常见排查方向及其处理措施总结。