Forge Viewer无需SVF转换原生加载PDF和DWF文件报错求解

传参合法性判断 #

直接将OSS存储的PDF签名URL传入viewer.loadModel()的用法本身符合Forge Viewer无SVF转换加载PDF的规范，加载报错通常是配置问题导致，可按以下步骤排查修复：

常见问题与解决方案 #

• 空accessToken校验失败：即使使用无需额外授权的签名URL，Autodesk.Viewing.Initializer配置中的accessToken也不能传入空字符串，可填入任意非空值占位即可，比如'temp'，空token会触发Viewer初始化校验逻辑直接报错。
• OSS CORS配置错误：你存储PDF的OSS Bucket必须配置CORS规则，允许你当前部署页面的域名发起GET请求，同时要开放Range请求头的允许权限，否则浏览器会拦截PDF二进制资源的分片请求，本地测试时需要把http://localhost:对应端口也加入允许的源列表。
• 签名URL无效：确认你生成的OSS签名URL具备read权限、未超出有效期，且URL中的region参数和Bucket实际所属区域一致，区域不匹配会返回403/404错误。
• 加载顺序异常：建议调整代码执行顺序，先加载Autodesk.PDF扩展再启动Viewer，同时增加错误回调参数方便定位具体报错原因，修改后的核心JS逻辑如下：

Autodesk.Viewing.Initializer({ accessToken: 'temp' }, async function () {
    const viewer = new Autodesk.Viewing.GuiViewer3D(document.getElementById('preview'));
    // 先加载PDF扩展再启动Viewer
    await viewer.loadExtension('Autodesk.PDF');
    viewer.start();
    // 增加成功/失败回调，方便定位问题
    viewer.loadModel(
        '替换为你的PDF签名URL',
        {},
        () => console.log('PDF加载成功'),
        (errCode, errMsg) => console.error('加载失败，错误码：', errCode, '错误信息：', errMsg)
    );
});

如果需要原生加载DWF文件，仅需将上述代码中加载的扩展替换为Autodesk.DWF即可，其余逻辑完全一致。

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