Forge Viewer缓存内存持续增长问题技术求助

在Forge Viewer中加载多个模型或重复加载模型时，内存缓存会持续累加，甚至超过1GB，以下是经过验证的缓解方案、配置及最佳实践：

一、主动清理模型资源 #

• 卸载模型时调用unloadModel并启用强制清理：

  // 卸载指定模型并清理缓存
  viewer.unloadModel(targetModel, true);
  

  第二个参数true会强制清除该模型的几何、纹理等缓存资源，避免残留占用内存。
• 清理全局引用：确保自定义代码中没有保留已卸载模型的对象引用（如模型实例、片段节点、事件监听器等），这些引用会阻止浏览器垃圾回收。

二、配置Viewer内存限制 #

初始化Viewer时通过配置项设定缓存阈值，触发自动清理：

const viewerConfig = {
  memoryLimit: 512 * 1024 * 1024, // 总内存限制（512MB），超出时自动清理缓存
  textureCacheSize: 64 * 1024 * 1024, // 纹理缓存上限
  geometryCacheSize: 128 * 1024 * 1024 // 几何数据缓存上限
};
const viewer = new Autodesk.Viewing.GuiViewer3D(container, viewerConfig);

根据业务场景调整数值，平衡加载速度与内存占用。

三、复用Viewer实例 #

避免频繁销毁重建Viewer，复用同一实例切换模型：

1. 卸载当前模型：viewer.unloadModel(currentModel, true)
2. 加载新模型：调用viewer.loadDocumentNode加载新模型
   这种方式减少了Viewer实例本身的内存开销，避免重复初始化带来的资源浪费。

四、优化模型加载选项 #

加载模型时关闭不必要的资源加载，减少内存占用：

viewer.loadDocumentNode(doc, viewable, {
  skipHiddenFragments: true, // 跳过隐藏部件的几何加载
  loadAsBackground: false, // 不加载背景模型（若无需）
  globalOffset: { x: 0, y: 0, z: 0 } // 避免不必要的坐标转换开销
});

五、监听内存告警并主动清理 #

通过Viewer的内存告警事件，在内存紧张时手动清理缓存：

viewer.addEventListener(Autodesk.Viewing.MEMORY_WARNING_EVENT, (event) => {
  switch (event.level) {
    case Autodesk.Viewing.MemoryWarningLevel.MEDIUM:
      viewer.clearTextureCache(); // 清理纹理缓存
      break;
    case Autodesk.Viewing.MemoryWarningLevel.HIGH:
      viewer.clearGeometryCache(); // 清理几何缓存
      viewer.clearTextureCache();
      break;
  }
});

六、最佳实践 #

• 优先使用SVF2格式：SVF2模型相比旧版SVF有更高效的内存管理机制，加载速度更快且内存占用更低。
• 定期分析内存快照：使用浏览器DevTools的Memory面板，拍摄内存快照对比，定位内存泄漏点（如未清理的事件监听器、全局引用等）。
• 自定义扩展资源清理：开发自定义Viewer扩展时，在unload方法中清理自身创建的资源（如Canvas、DOM元素、定时器、事件监听器等）。

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