原因分析 #

• 集群元数据残留无效节点记录：IoTDB的ConfigNode会维护全集群的节点元数据，若之前集群部署（含测试环节）中曾添加过主机名为"iotdb"的节点，后续删除时未清理元数据，或者节点配置的RPC地址被设为"iotdb"并注册到元数据，SessionPool会定期从ConfigNode拉取最新节点列表，进而尝试连接该残留节点。
• 节点配置的RPC地址异常：部分ConfigNode或DataNode的配置文件中，将自身的cn_rpc_address（ConfigNode）或dn_rpc_address（DataNode）设为了"iotdb"，导致集群元数据中注册了该地址，客户端SessionPool同步元数据后触发连接尝试。
• SessionPool自动节点发现机制：IoTDB SessionPool默认开启自动节点发现功能，会从初始连接的ConfigNode获取集群所有节点信息（含DataNode和ConfigNode），并尝试为这些节点建立连接，若元数据中存在"iotdb"节点，就会出现该警告。

解决思路 #

1. 清理集群元数据中的无效节点 #

• 用IoTDB客户端连接任意正常的ConfigNode，执行以下命令查看所有节点：

  SHOW ALL DATANODES;
  SHOW ALL CONFIGNODES;
  

• 若输出中存在iotdb:6667的节点，且该节点已下线，执行对应命令删除：

  -- 删除无效DataNode
  DELETE DATANODE 'iotdb:6667';
  -- 删除无效ConfigNode（若存在）
  DELETE CONFIGNODES 'iotdb:6667';
  

2. 检查并修正节点配置文件 #

• 遍历所有ConfigNode和DataNode的iotdb-common.properties配置文件，检查以下参数：
  • ConfigNode：cn_rpc_address、cn_internal_address
  • DataNode：dn_rpc_address、dn_internal_address
• 若上述参数值为"iotdb"，修改为集群内可解析的IP或合法主机名，修改后重启对应节点。

3. 关闭SessionPool的自动节点发现（可选） #

• 若集群节点固定，无需自动发现新节点，可在构建SessionPool时关闭该功能，此时SessionPool仅使用初始化传入的nodeUrls列表，不会从集群拉取其他节点。修改后的代码示例：

  public SessionPool createSessionPool() {
      List<String> nodeUrls = new ArrayList<>(this.nodeUrls);
      SessionPool sessionPool =
                  new SessionPool.Builder()
                  .nodeUrls(nodeUrls)
                  .user(username)
                  .password(password)
                  .maxSize(500)
                  .enableNodeDiscovery(false) // 关闭自动节点发现
                  .build();
      // 后续逻辑
      return sessionPool;
  }
  

• 注意：该方式不适合需要动态扩容的集群，扩容时需手动更新客户端的nodeUrls列表。

4. 修复主机名解析问题（若"iotdb"为合法节点） #

• 若"iotdb"是集群中存在的节点，但客户端机器无法解析该主机名，需在客户端的hosts文件中添加映射关系（例如：192.168.1.100 iotdb），或修改集群节点的RPC地址为客户端可解析的地址。

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