Autodesk Forge 单选零件无法直接切换关联PDF分页的问题求解

问题根因 #

你初步判断PDF分页参数pdf#page的逻辑存在异常的结论是符合实际现象的。该异常不属于Forge Viewer的选中事件逻辑缺陷，核心触发原因是浏览器对同基础路径的PDF资源，仅修改URL末尾的hash片段（即#page=xxx分页参数）时，不会触发内嵌PDF查看器的重载与分页跳转流程。

• 直接切换两个零件的选中状态时，两次给embed元素设置的src的基础PDF路径完全一致，仅分页参数存在差异，浏览器会判定该PDF资源已完成加载，不会重新执行读取hash分页参数的逻辑，因此PDF内容不会更新。
• 操作流程插入“取消选中零件”的环节时，代码会进入分支把embed的src置为空字符串，相当于先卸载了已加载的PDF，再次设置带分页参数的src时，会触发完整的PDF加载流程，因此可以正常跳转到对应页码。
• 你观察到的同类公开示例存在的相同问题，本质也是采用了原生embed加载PDF、仅依赖hash传递分页参数的实现方式，未做浏览器行为的适配。

具体实现方案 #

方案1：给PDF URL拼接唯一随机参数，强制触发资源重载 #

利用浏览器缓存判断规则，给基础PDF路径拼接一个不影响实际资源加载的唯一标识，让每次设置的URL都与上一次有明确差异，绕过浏览器的同资源缓存判定：
将原有代码中设置embed src的逻辑：

$('#maintenance-docs embed').attr('src', `/resources/Operation-manual-Sigg-Plant.pdf#page=${page}`).show();

替换为：

const page = results[0].selection[0] % 100;
// 拼接当前时间戳作为唯一参数，让每次URL都为新资源
const pdfUrl = `/resources/Operation-manual-Sigg-Plant.pdf?nonce=${Date.now()}#page=${page}`;
$('#maintenance-docs embed').attr('src', pdfUrl).show();

提示：追加在查询参数里的随机值不会影响PDF资源的正常返回，仅用于让浏览器识别需要重新请求并加载PDF，进而触发内置查看器读取hash中的page参数完成分页跳转。

方案2：更新PDF时先清空embed资源，短延迟后再重新赋值 #

不需要额外拼接随机参数，模拟“取消选中再选中零件”的流程，每次需要更新PDF页码时，先临时清空embed的src，等待极短延迟后再设置对应分页的地址，完全复现之前可以正常生效的操作流程：

const $embed = $('#maintenance-docs embed');
const page = results[0].selection[0] % 100;
// 先清空已加载的PDF
$embed.attr('src', '');
// 短延迟后重新加载对应页码的PDF
setTimeout(() => {
    $embed.attr('src', `/resources/Operation-manual-Sigg-Plant.pdf#page=${page}`).show();
}, 50);

方案3：替换原生embed加载逻辑，使用PDF.js独立实例控制分页 #

如果对交互体验有更高要求，可以弃用浏览器原生的PDF嵌入能力，引入PDF.js在指定容器内渲染PDF内容：

• 初始化时加载PDF文档实例，每次切换零件选中状态时，直接调用PDF.js的接口渲染对应页码的内容
• 完全绕开浏览器对hash参数的识别逻辑，加载性能更稳定，不会出现缓存导致的不刷新问题，适合长期迭代的功能场景。

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