在订单详情页里,用户先点“合同 A”,马上又点“报价 B”。列表已经选中 B,右侧却过了一会儿显示 A。下载按钮如果还跟着列表选中项走,用户就可能看到一份文件、下载另一份文件。
这通常要先检查请求和展示状态的对应关系。A 的请求先发出,却可能比 B 更晚返回;如果每次成功回调都直接更新预览区,旧结果就会盖住新选择。下面按“取附件信息、打开 PDF、显示可操作状态”拆开排查。
选中项、加载项和已展示项,不是同一个状态
在应用里分别维护三项:
selectedId:用户最后一次选择的附件。loadingId:正在为哪份附件取得地址或加载文档。displayedId:查看器已经完成打开、当前真正显示的附件。
下载、批注和保存按钮应根据已展示文档及其加载结果启用,不能只看列表高亮。切换开始后,可以隐藏旧文档或用明显的遮罩阻止操作;不要让旧内容留在可点击区域,旁边却显示新文件名。
这里的字段是应用状态设计,不是 PDF SDK 的固定返回值。一个附件加载失败,也不应把所有附件都标成失败。
图:请求顺序示意,PDF 打开过程还需另行处理。
先挡住过期的附件信息请求
每次选择文件时生成一个递增序号。回调准备更新页面前,检查它是不是最新的一次。下面的函数只负责取附件信息,可以在浏览器或 Node.js 18+ 中独立运行;它不负责打开 PDF。
function createLatestLoader(loadInfo, applyInfo, showError) {
let sequence = 0;
let controller;
return async function select(id) {
const current = ++sequence;
controller?.abort();
const request = new AbortController();
controller = request;
try {
const info = await loadInfo(id, request.signal);
if (current !== sequence) return;
applyInfo(id, info);
} catch (error) {
if (current !== sequence || error.name === "AbortError") return;
showError(id, error);
}
};
}
loadInfo 由业务接口实现,必须把 signal 传给实际的 fetch;applyInfo 和 showError 是页面自己的回调。即使接口或模拟请求不响应取消,序号检查也能阻止旧的成功结果和旧的错误覆盖当前项。取消请求用于减少无用工作,序号用于判断结果是否还有效,两者作用不同。
可以先用延迟请求验证顺序,不需要接入真实附件:
const seen = [];
const select = createLatestLoader(
(id) => new Promise((resolve) => {
setTimeout(() => resolve({ id }), id === "A" ? 80 : 10);
}),
(id) => seen.push(id),
(id) => seen.push(`error:${id}`)
);
await Promise.all([select("A"), select("B")]);
console.log(seen); // ["B"]
这段验证只能说明附件信息回调不会乱序更新,不能证明 PDF 查看器的打开过程已经处理好。
查看器真正打开后,再更新已展示项
如果使用 ComPDF Web SDK,可从打开文档说明核对当前版本接受的文件类型与打开方式。URL、Blob 等输入的取得过程由应用负责,文件本身的查看、批注及表单交互交给组件。
关键是不要在“取得地址”时就标记 PDF 已经可用。接入时还需要处理查看器的完成事件或返回结果,并确认它对应本次打开的文件。
对于无法可靠取消、且完成事件不能区分请求的查看器,不要并发调用同一个实例的打开方法。采用串行打开:一次只处理一个文件;过程中有新选择就记录最后一个目标,当前操作完成后再打开该目标,期间保持预览区不可操作。只有最终目标打开成功,才更新 displayedId、文件名和操作按钮。
如果改用独立实例承载每次预览,也要销毁旧实例并隔离旧事件,不能只把旧 DOM 隐藏起来。采用哪种方案,应依据实际组件版本的生命周期与资源开销决定。
切换前,处理未保存的修改
纯阅读页面可以直接切换。已经允许批注或填写表单的页面,需要先决定“保存后切换、放弃修改、取消切换”。这一步应发生在卸载旧文档之前。
保存时从当前已展示的文档实例取得数据,关联它自己的附件 ID 和版本。不要把新选中项的 ID 与旧文档导出的数据组合上传。具体导出方式可对照 ComPDF 的保存文档接法;服务器保存完成与浏览器导出完成仍需分别处理。
地址过期时重新向自己的后端申请访问地址,并重新检查权限。不要通过把长期凭据写进前端来消除过期错误。
用四条路径检查是否真的修好
- 把 A 请求人为放慢,快速点 A、B,最终预览、标题和下载目标都应是 B。
- 让 A 的请求晚到并失败,B 已打开后,页面不应被 A 的错误提示覆盖。
- B 无权限或加载失败时,明确显示 B 的错误;不能把 A 留在预览区冒充 B。
- 在 A 加一条批注再切换 B,取消切换应继续留在 A;选择保存时,应先确认 A 的保存结果,再切换到 B。
排查附件切换,先让“用户选了谁、系统正在加载谁、当前实际显示谁”对应起来,再接入 PDF 查看与编辑。这样遇到错文件、旧错误或修改丢失时,就能沿着具体状态找到问题,而不是把所有失败都归到一个 loading 上。