开发Data Visualization Extension遇TypeError：无法读取undefined的forEach属性

问题详情 #

• 开发Data Visualization Extension时，已完成传感器数据集创建、与Revit模型适配，并参照官方文档配置SQLite Data Adapter。
• 模型在localhost:9000加载后，界面未显示传感器列表及数据，控制台抛出错误：Uncaught (in promise) TypeError: Cannot read properties of undefined (reading 'forEach')

相关截图 #

错误原因及排查方案 #

这个forEach未定义错误，本质是代码尝试遍历一个不存在（undefined）的数据集，结合你的场景，可按以下步骤逐一排查：

1. 检查SQLite数据源有效性 #

• 确认数据库文件路径正确：本地开发时易出现相对路径错误，可改用绝对路径测试，排除路径问题。
• 验证数据库表结构与数据：用SQLiteStudio等工具打开数据库，确认sensors表存在，包含sensor_id、model_element_id等必填字段，且表内有实际数据。

2. 排查Data Adapter配置 #

• 检查Adapter初始化代码：确保SQLiteAdapter实例化时传入正确的数据库路径，且初始化过程已正确处理异步逻辑（比如用await等待初始化完成）。
• 确认Adapter已注册到Extension：检查是否将Adapter实例添加到DataVisualizationExtension的dataAdapters列表中，未注册的话Extension无法读取数据源。

3. 验证模型与数据的ID匹配 #

• 传感器数据中的model_element_id必须和Revit模型元素的Forge ID完全一致。可通过Forge Viewer的选择工具查看元素ID，对比数据库中的ID格式（注意字符串/数字类型差异）。

4. 修复异步代码的空值判断 #

• 报错来自Promise回调，说明数据读取后未做空值校验。修改代码，在执行forEach前先判断数据是否存在且为数组：

// 优化后的异步数据加载示例
const loadSensorData = async () => {
  try {
    const adapter = new Autodesk.DataVisualization.Core.SQLiteAdapter('./sensors.db');
    const sensors = await adapter.getSensorData();
    if (Array.isArray(sensors)) {
      sensors.forEach(sensor => {
        // 处理传感器数据渲染逻辑
      });
    } else {
      console.error('传感器数据集为空或格式错误');
    }
  } catch (err) {
    console.error('加载传感器数据失败:', err);
  }
};

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