Autodesk Forge Viewer PDF扩展如何阻止查询串page参数覆盖loadModel值

Forge Viewer PDF扩展对URL中page参数的优先覆盖逻辑为内置默认实现，目前没有提供官方直连开关可一键禁用该特性，可通过以下三种低改造成本的方案规避和现有业务分页参数的冲突，完全不需要对现有page查询参数做大规模重命名：

• 代理拦截Viewer的参数读取流程（零侵入业务逻辑）
  这是改造成本最低的方案。Forge Viewer的所有URL参数读取统一通过Autodesk.Viewing.getQueryParam公共方法完成，你可以在触发PDF加载前给这个方法加一层逻辑代理，只针对PDF扩展的参数读取请求拦截page参数的返回值。
  整个过程完全不影响你业务侧直接读取URL中的page参数做表格分页逻辑，因为代理逻辑只对Viewer内部的参数调用生效。
  示例代码：

  // 缓存原始参数读取方法
  const originalGetQueryParam = Autodesk.Viewing.getQueryParam;
  // 覆写参数读取方法
  Autodesk.Viewing.getQueryParam = function(targetParam) {
    // 仅在PDF扩展加载阶段拦截对page参数的读取
    if (targetParam === 'page' && window._pdfLoadInProgress) {
      return null;
    }
    // 其余场景完全走原始逻辑，不影响业务参数读取
    return originalGetQueryParam.apply(this, arguments);
  }
  
  // 触发PDF加载前打状态标记
  window._pdfLoadInProgress = true;
  viewer.loadModel('path/to/file.pdf', { page: 1 });
  window._pdfLoadInProgress = false;
  

• 自定义PDF扩展的参数键名（无侵入底层方法）
  针对v7.x及以上版本的Forge Viewer，PDF扩展初始化时支持通过配置自定义要读取的URL参数名，你可以把扩展默认读取的page参数改成和业务无冲突的名称（比如pdfPage），从根源上避免和现有表格分页用的page参数冲突。
  配置示例：

  // 初始化PDF扩展时传入自定义参数名配置
  viewer.loadExtension('Autodesk.PDF', {
    pageParamName: 'pdfPage'
  });
  

  配置完成后，PDF扩展只会读取URL中pdfPage键的值，不会再读取、覆盖你传给loadModel的page参数，现有业务的page参数完全不需要改名。

• 临时调整URL参数完成加载后还原
  如果不想改动公共方法、也不满足扩展版本要求，可以在触发PDF加载的瞬间，通过History API把URL里的page参数临时重命名为非冲突键，等PDF扩展的参数解析流程走完（通常是loadModel调用后的100ms内），再把URL参数改回原来的page值。
  整个参数替换过程是同步完成的，用户不会感知到URL变化，也不需要改动业务侧的分页逻辑。

注意：不要尝试把page参数移到URL hash部分来规避冲突，Forge Viewer的参数解析逻辑会同时读取query和hash段的同名参数，这种隔离方式是无效的。

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