Apache IoTDB 1.1.0（Docker版）insertRecord失败报错301如何解决？

针对你遇到的301: [EXECUTE_STATEMENT_ERROR(301)] Exception occurred: insertRecord failed. org.apache.iotdb.commons.exception.IoTDBException: ConfigNode failed to extend Region because there are not enough DataNodes错误，可按以下步骤排查解决：

• 检查DataNode的在线状态与数量

  1. 进入ConfigNode容器，启动IoTDB命令行客户端：

     iotdb-cli -h <confignode-ip> -p 6667 -u root -pw root
     

     执行SHOW DATANODES命令，查看所有DataNode的在线状态和总数量。IoTDB扩展Region需要满足可用DataNode数量≥Region副本数，若只有1个DataNode或部分节点离线，会触发该错误。
  2. 用Docker命令检查DataNode容器状态：

     docker ps | grep iotdb-datanode
     

     确认所有DataNode容器处于Up状态，无异常退出或重启。

• 核对Region副本数配置

  1. 进入ConfigNode或DataNode容器，打开配置文件/iotdb/conf/iotdb-common.properties，找到region_replica_num参数。
  2. 确保该参数值≤当前可用DataNode数量。例如副本数设为3但只有2个DataNode，就无法完成Region扩展。修改后需重启所有ConfigNode和DataNode容器。

• 手动触发Region平衡
  若DataNode数量足够但仍报错，在IoTDB CLI中执行：

  BALANCE REGION
  

  强制触发Region重新分配，让ConfigNode重新识别可用DataNode资源。执行后用SHOW REGIONS查看Region分布，确认扩展是否成功。

• 排查Docker网络连通性

  1. 确保ConfigNode与所有DataNode在同一Docker网络内，可在容器内ping其他节点的容器名或IP测试连通性。网络不通会导致ConfigNode判定DataNode不可用，误判为数量不足。
  2. 若用Docker Compose部署，检查docker-compose.yml的网络配置，确认所有节点归属同一网络，端口（如6667、10710、10720）映射正确。

• 查看ConfigNode日志定位细节
  进入ConfigNode容器，查看日志文件/iotdb/logs/iotdb-confignode.log，搜索not enough DataNodes关键词，日志会明确说明当前可用DataNode数量、所需数量等信息，帮助定位具体原因。

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