Apache IoTDB Session的executeQueryStatement无结果返回，CLI查询正常

• 核心问题：未正确遍历结果集
  executeQueryStatement返回的SessionDataSet包含列名这类元数据，也包含实际数据行，但数据行不会自动返回，必须通过hasNext()和next()方法主动遍历读取。很多开发者只获取了列名就终止操作，自然看不到结果。

• 正确使用示例
  以下是完整的查询并读取结果的代码片段：

  try (Session session = new Session("localhost", 6667, "root", "root")) {
      session.open(false);
      String sql = "select * from root.test.device.* where time <= now()";
      SessionDataSet dataSet = session.executeQueryStatement(sql);
  
      // 打印列名
      System.out.println("列名：" + dataSet.getColumnNames());
  
      // 遍历所有结果行
      while (dataSet.hasNext()) {
          RowRecord record = dataSet.next();
          // 获取时间戳
          long ts = record.getTimestamp();
          // 获取每行的字段值
          List<Field> fields = record.getFields();
          System.out.printf("时间戳: %d, 数据: %s%n", ts, fields);
      }
  } catch (IoTDBConnectionException | StatementExecutionException e) {
      e.printStackTrace();
  }
  

• 额外排查点

  1. 确认客户端执行的SQL与CLI完全一致：检查是否存在字符串拼接错误（比如时间参数格式、设备路径大小写，IoTDB默认对路径大小写不敏感，但字符串类型值区分大小写）。
  2. 检查fetchSize配置：如果结果集较大，可显式设置session.setFetchSize(1000)（默认值可能较小，需确保遍历过程中能触发数据拉取）。
  3. 避免事务上下文干扰：如果查询是在未提交的事务中执行，可能无法获取最新数据，查询操作建议在事务外部执行。

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