Apache IoTDB集群版（1C1D）代码连接失败排查求助

针对你遇到的1C1D集群版本地CLI可连接但代码无法连接的情况，可从以下几个方向检查配置或代码逻辑：

• 确认连接端口与地址正确性
  集群版默认客户端RPC端口为6667（对应conf/iotdb-common.properties中的rpc_port配置项），需确保代码中使用的端口与该配置一致。同时，若代码运行环境与IoTDB服务器不在同一机器，必须使用服务器的内网/公网IP而非localhost——本地CLI默认使用localhost所以能成功连接，跨机器访问时则需指定正确IP。

• 检查IP白名单配置
  查看conf/iotdb-common.properties中的rpc_allow_list参数，若该参数已设置特定IP列表，需将代码运行机器的IP添加至列表中。默认该参数为空，允许所有IP访问，但若修改过则会限制非白名单IP的连接。

• 匹配客户端与服务器版本
  代码中使用的IoTDB客户端SDK版本必须与服务器版本完全一致（包括主版本、次版本及补丁版本），版本不兼容会导致连接握手失败。例如服务器为1.3.0，客户端依赖也需指定为1.3.0。

• 排查SSL加密配置
  若服务器开启了SSL加密（conf/iotdb-common.properties中rpc_enable_ssl设为true），代码中必须同步配置SSL相关参数（如信任证书路径）才能建立连接。本地CLI若未添加SSL参数即可连接，说明服务器大概率未开启SSL，此时代码中无需配置SSL。

• 查看服务器日志定位问题
  前往IoTDB的logs目录，查看iotdb.log或confignode.log，搜索connection、reject等关键词，获取具体的连接失败原因（如认证错误、端口占用、权限限制等），这是最直接的排查方式。

• 参考正确的代码连接示例
  以Java客户端为例，正确的集群连接代码如下：

import org.apache.iotdb.session.Session;

public class IoTDBClusterConnection {
    public static void main(String[] args) {
        String serverIp = "你的服务器IP地址";
        int rpcPort = 6667;
        String username = "root";
        String password = "root";

        Session session = new Session(serverIp, rpcPort, username, password);
        try {
            session.open();
            System.out.println("集群连接成功");
            // 执行后续操作
            session.close();
        } catch (Exception e) {
            System.err.println("连接失败，错误信息：");
            e.printStackTrace();
        }
    }
}

内容的提问来源于stack exchange，提问作者yana shen