Forge Viewer(SVF2)加载模型无法接收全部数据相关问题咨询

1. 稳定网络环境下的单模型加载超时时长参考 #

不要给所有模型硬套统一超时阈值，高速稳定网络（下行带宽≥100Mbps、丢包率<0.1%、RTT<50ms）场景下，按模型体量分级设置即可：

• 轻量化模型（总包体积<100MB，构件数<1万）：设置30s超时
• 中等体量模型（总包体积100MB_{1GB，构件数1万}10万）：设置90s超时
• 大体量模型（总包体积>1GB，构件数>10万）：设置180s超时

*注意：超时触发后不要直接判定加载失败，先做一次状态校验，避免把慢加载的正常模型误判为失败。你观察到的「首次加载偶发异常、缓存后加载正常」的特征和SVF2的加载逻辑完全匹配：SVF2会把几何、属性数据拆成大量小分块按需拉取，首次加载需要走网络请求所有分块，一旦某个分块请求出现静默失败（既不抛错也不触发完成回调），就会出现对象树/几何数据缺失的问题；缓存命中后浏览器直接读取本地缓存资源，不发起网络分块请求，自然不会触发这类异常。

2. 可靠的加载状态判断方法 #

model.loader.loading是全局loader实例的累计状态标记，不会随单个模型加载完成自动复位，从设计上就不适合作为单模型加载状态的判断依据，不要使用这个属性。

要解决偶发事件丢失、状态标记不准的问题，必须用事件监听+主动轮询校验的双保险方案，不要只依赖事件回调判断加载结果：

1. 加载单模型时绑定专属的完成、错误事件，回调触发后先做数据校验再判定结果，参考代码如下：

const loadSingleModel = (viewer, modelUrl, options) => {
  return new Promise((resolve, reject) => {
    let targetModel = null;
    // 监听模型加载完成事件
    const onGeomLoaded = (evt) => {
      if (evt.model !== targetModel) return;
      cleanup();
      // 事件触发后二次校验数据，避免事件误触发
      if (isModelReady(targetModel)) return resolve(targetModel);
      // 数据未就绪则启动轮询兜底
      startReadyCheck(targetModel, resolve, reject);
    };
    // 监听加载错误事件
    const onLoadError = (evt) => {
      if (evt.modelId !== targetModel?.id) return;
      cleanup();
      reject(new Error(`模型加载失败: ${evt.message || '未知错误'}`));
    };
    const cleanup = () => {
      viewer.removeEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, onGeomLoaded);
      viewer.removeEventListener(Autodesk.Viewing.ERROR_EVENT, onLoadError);
    };
    viewer.addEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, onGeomLoaded);
    viewer.addEventListener(Autodesk.Viewing.ERROR_EVENT, onLoadError);
    // 启动加载
    viewer.loadModel(modelUrl, options, (model) => {
      targetModel = model;
    });
  });
};

// 模型就绪校验逻辑
const isModelReady = (model) => {
  return Boolean(
    model.isLoadDone() 
    && model.getInstanceTree() 
    && model.getFragmentList()
  );
};

2. 增加轮询兜底逻辑，解决事件静默丢失的问题：

• 轮询间隔设置为1~2s即可，频率过高会占用主线程影响渲染性能
• 每次轮询调用isModelReady方法校验三个核心状态：isLoadDone()返回true、对象树实例非空、几何分片列表非空，三个条件同时满足才算加载完成
• 轮询时长达到对应模型体量的超时阈值后，判定为加载失败
• 判定失败后可以自动重试1次：不需要销毁整个Viewer实例，只需要调用model.unload()卸载异常模型后重新触发加载即可，90%以上的首次网络波动导致的静默失败都可以通过一次无感知重试解决，不需要用户手动刷新页面。

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