求助：Forge Viewer加载模型触发onDocumentLoadFailure() - errorCode:7跨域错误

这个问题我之前帮同事排查过好几次，是Forge Viewer里很常见的跨域资源共享（CORS）配置问题，咱们一步步来解决：

先搞懂错误根源 #

你看到的报错信息里，Origin 'null'是关键——这通常意味着你的页面是直接通过file://协议打开的（比如双击本地HTML文件），而不是通过HTTP服务器加载。这种情况下，浏览器会把请求源标记为null，而Forge API或者你的模型服务器的CORS配置不允许这种源访问，就触发了errorCode:7的加载失败。

具体解决步骤 #

1. 改用本地HTTP服务器运行页面 #

别再直接双击HTML文件了，启动一个简单的本地HTTP服务器：

• Python用户：打开终端，进入代码目录，运行python -m http.server 8000（Python3）或者python -m SimpleHTTPServer 8000（Python2）
• Node.js用户：先全局安装http-server：npm install -g http-server，然后在代码目录运行http-server -p 8000
• 之后通过http://localhost:8000访问你的页面，此时请求的Origin会变成http://localhost:8000，符合CORS的正常校验规则。

2. 检查Forge应用与服务器的CORS配置 #

如果是加载Forge OSS里的模型，或者自己服务器托管的模型：

• Forge应用端：登录Forge开发者控制台，找到你的应用，确保回调域名列表里包含你的页面域名（比如http://localhost:8000）
• 自有服务器端：如果模型存在你自己的服务器上，需要在服务器配置里添加CORS头，允许页面域名访问：
  • Nginx配置示例：

    add_header Access-Control-Allow-Origin http://localhost:8000;
    add_header Access-Control-Allow-Methods GET, POST, OPTIONS;
    add_header Access-Control-Allow-Headers Content-Type;
    

  • Apache配置示例：

    Header set Access-Control-Allow-Origin "http://localhost:8000"
    

3. 确认模型加载路径正确 #

确保你传给Viewer的模型URN或者文件URL是HTTP/HTTPS协议的可访问地址，不是本地的文件路径（比如C:/models/xxx.svf）。如果是本地模型，先上传到Forge OSS或者你的HTTP服务器，再用对应的URL加载。

开发环境临时绕过方案（仅测试用，禁止生产环境使用） #

如果只是临时测试想跳过CORS校验，可以给浏览器加启动参数：

• Chrome：右键快捷方式，在目标栏末尾添加 --disable-web-security --user-data-dir="C:/ChromeDevSession"（注意前面有空格），启动后会提示“您使用的是不受支持的命令行标记”，正常使用即可
• Firefox：安装CORS Everywhere类的插件，启用后临时绕过校验

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