Adobe PDF Embed API的gotoLocation()方法无法跳转页面

问题描述 #

我们在Angular页面中使用Adobe PDF Embed API加载PDF，通过gotoLocation()方法在PDF渲染完成后跳转到指定页面。代码如下：

pdfFilePromise.then(adobeViewer => {
          console.log('file rendered')
          if (this.item.pageId) {
            console.log('opening page', this.item.pageId)
            adobeViewer.getAPIs().then((apis: any) => {
              apis.gotoLocation(this.item.pageId)
                .then((data) => {console.log("Page opening Success");
                   console.log(data) })
                .catch((error: any) => console.log('Page opening error', error));
            });
          }
}

当前PDF能正常加载，但调用gotoLocation()后返回成功（data为true），却始终停留在第一页，无法跳转至指定页面。该功能此前稳定运行3个月，近期无代码部署变更，今日突然在所有环境失效。

排查与解决方向 #

• 锁定Adobe API版本：Adobe可能推送了API的静默更新，导致gotoLocation()行为变化。初始化Embed API时添加version参数，锁定到之前可用的版本（如"3.0"），避免自动使用最新版本。
• 检查页面索引规则：确认this.item.pageId的索引类型，部分PDF渲染工具页面索引从0开始而非1。若API实际需要0-based索引，需将this.item.pageId减1后传入gotoLocation()。
• 等待PDF完全就绪：file rendered回调仅表示PDF开始渲染，而非所有资源加载完毕。改用监听documentReady事件，在PDF完全就绪后再调用跳转方法，示例代码调整如下：

pdfFilePromise.then(adobeViewer => {
  adobeViewer.registerCallback(AdobeDC.View.Enum.CallbackType.DOCUMENT_READY, () => {
    console.log('document fully ready');
    if (this.item.pageId) {
      console.log('opening page', this.item.pageId);
      adobeViewer.getAPIs().then((apis: any) => {
        // 若需转换索引，此处添加处理：const targetPage = this.item.pageId - 1;
        apis.gotoLocation(this.item.pageId)
          .then((data) => {console.log("Page opening Success"); console.log(data)})
          .catch((error: any) => console.log('Page opening error', error));
      });
    }
  });
});

• 验证PDF文件完整性：确认目标PDF的页面数量大于this.item.pageId，部分PDF可能存在页面损坏或索引异常，导致跳转失效但返回成功。

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