首次打开图纸时Forge Viewer出现404错误问题咨询

问题根源 #

首次加载时Viewer错误地向http://localhost/derivativeservice请求衍生数据，而本地并未部署该服务，导致404；后续请求自动切换到Autodesk官方CDN（https://cdn.derivative.autodesk.com）是Viewer的 fallback机制，但首次错误可通过配置避免。

修复步骤 #

• 正确设置Viewer初始化的环境参数
  初始化Viewer时必须指定env参数为官方环境，确保Viewer从一开始就使用Autodesk的服务而非本地地址：

  Autodesk.Viewing.Initializer({
      env: 'AutodeskProduction', // 生产环境，测试环境可用'AutodeskStaging'
      accessToken: 'YOUR_ACCESS_TOKEN' // 替换为你的有效访问令牌
  }, function() {
      // 此处编写Viewer实例化及加载模型的代码
  });
  

• 强制指定衍生服务Endpoint
  若环境参数仍未生效，可直接通过api参数明确指定CDN地址，彻底避免本地请求：

  Autodesk.Viewing.Initializer({
      env: 'AutodeskProduction',
      accessToken: 'YOUR_ACCESS_TOKEN',
      api: 'https://cdn.derivative.autodesk.com'
  }, function() {
      // Viewer初始化逻辑
  });
  

• 移除无效本地代理配置
  若你曾配置过指向localhost/derivativeservice的反向代理规则，且并未实际部署该服务，请删除此代理配置，避免拦截请求并转向无效地址。

• 清除浏览器缓存
  旧的缓存配置可能导致首次加载时的错误请求，清除浏览器缓存后重新测试页面，确保新配置生效。

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