如何在Forge Viewer中加载本地.svf文件？加载报错的解决方法

常见报错原因 #

• SVF文件不完整或加载路径错误：你直接加载的output.svf只是模型的一部分，Forge Viewer加载本地模型需要依赖完整的导出文件包（包括附属的.bin几何文件、.json属性文件等），且正确的入口应该是导出的manifest.json文件，而非单独的svf文件。
• 本地文件跨域限制：直接通过file://协议打开本地HTML文件时，浏览器会阻止跨域访问本地资源，导致模型文件无法正常加载。
• 本地HTTP服务缺失：Viewer的本地模式仍需要通过HTTP协议访问文件，而非直接读取本地文件系统。

解决步骤 #

1. 确认导出文件结构
   检查models/model1文件夹下的文件，应该包含manifest.json、output.svf、以及一系列output_f*.bin、output_f*.json等文件。如果没有manifest.json，重新通过forge-convert-utils导出完整的模型包，确保导出过程未中断。

2. 修正代码中的模型路径
   将MODEL_URL改为指向manifest文件，而非svf文件：

   const MODEL_URL = './models/model1/manifest.json';
   Autodesk.Viewing.Initializer({ env: 'Local' }, async function () {
       const viewer = new Autodesk.Viewing.GuiViewer3D(document.getElementById('preview'));
       viewer.start(MODEL_URL);
   });
   

3. 启动本地HTTP服务器
   不要直接双击打开HTML文件，在项目根目录启动一个本地HTTP服务：

   • Node.js环境：执行 npx serve，访问 http://localhost:3000
   • Python环境：执行 python -m http.server 8000，访问 http://localhost:8000

4. 清理无关代码（可选）
   代码中download()函数调用的/api/download接口在本地环境不存在，会触发额外404错误，建议暂时注释或删除该部分代码，避免干扰模型加载排查。

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