Autodesk Forge Viewer PDF功能异常问题技术咨询

这问题我之前帮同行排查过类似的，咱们分两个版本的情况逐一拆解：

一、Viewer 3.1.3版本：新上传PDF报404，旧PDF正常 #

这种新旧PDF表现差异的情况，大概率是Derivative Service生成的资源路径格式变化导致的：

• 旧PDF是去年转换的，当时Derivative Service生成的PDF衍生资源路径和现在的格式不一样，而3.1.3是比较老旧的版本，无法兼容新的路径规则；
• 新上传的PDF转换后，Viewer 3.1.3找不到对应的资源文件，所以抛出404。

排查与解决建议 #

• 调用Forge的GET derivative manifest接口，对比新旧PDF的derivative结构，重点看viewables数组里每个页面的urn字段格式；
• 优先考虑升级Viewer版本（比如直接跳到3.3+并解决对应问题），因为3.1.3早已不在官方维护范围内，后续兼容性问题只会更多；
• 如果暂时不能升级，可以尝试调整PDF转换时的参数（比如指定outputFormat为pdf时的额外配置），让Derivative Service生成兼容旧版本Viewer的资源路径。

二、Viewer 3.3版本：仅加载第一页，切换页面调用selectItem报错 #

3.3版本对多页PDF的viewable结构处理逻辑有更新，原来用viewerApp.selectItem()切换页面的方式已经不适用了，原因如下：

• viewerApp.selectItem()主要用于切换不同的文档/模型，而不是同一个PDF文档内的不同页面；
• 3.3版本中，多页PDF的每个页面是作为同一个document下的不同viewable node存在的，需要用文档节点加载的方式切换。

修复步骤 #

替换原来的selectItem调用逻辑，改用以下方式切换页面：

// 假设你已经拿到了目标页面的viewable项
const targetViewable = viewables[id];
// 获取当前加载的文档实例
const currentDoc = viewerApp.getCurrentDocument();
// 根据viewable的guid找到对应的文档节点
const viewableNode = currentDoc.getRoot().findByGuid(targetViewable.data.guid);
// 调用loadDocumentNode切换页面
viewer.loadDocumentNode(currentDoc, viewableNode)
  .then(() => {
    console.log('页面切换成功');
  })
  .catch(err => {
    console.error('页面切换失败:', err);
  });

额外检查点 #

• 确保Viewer初始化时已经加载了Autodesk.PDF扩展，这是PDF功能正常运行的基础；
• 打印viewables数组的完整结构，确认每个页面的data字段包含正确的guid或name标识，避免选择了无效的viewable项。

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