点开 B 附件,却显示 A 的 PDF?检查文件切换的异步顺序

0 阅读5分钟

在订单详情页里,用户先点“合同 A”,马上又点“报价 B”。列表已经选中 B,右侧却过了一会儿显示 A。下载按钮如果还跟着列表选中项走,用户就可能看到一份文件、下载另一份文件。

这通常要先检查请求和展示状态的对应关系。A 的请求先发出,却可能比 B 更晚返回;如果每次成功回调都直接更新预览区,旧结果就会盖住新选择。下面按“取附件信息、打开 PDF、显示可操作状态”拆开排查。

选中项、加载项和已展示项,不是同一个状态

在应用里分别维护三项:

  • selectedId:用户最后一次选择的附件。
  • loadingId:正在为哪份附件取得地址或加载文档。
  • displayedId:查看器已经完成打开、当前真正显示的附件。

下载、批注和保存按钮应根据已展示文档及其加载结果启用,不能只看列表高亮。切换开始后,可以隐藏旧文档或用明显的遮罩阻止操作;不要让旧内容留在可点击区域,旁边却显示新文件名。

这里的字段是应用状态设计,不是 PDF SDK 的固定返回值。一个附件加载失败,也不应把所有附件都标成失败。

A 请求慢返回,B 后发先至的异步顺序示意

图:请求顺序示意,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 的保存文档接法;服务器保存完成与浏览器导出完成仍需分别处理。

地址过期时重新向自己的后端申请访问地址,并重新检查权限。不要通过把长期凭据写进前端来消除过期错误。

用四条路径检查是否真的修好

  1. 把 A 请求人为放慢,快速点 A、B,最终预览、标题和下载目标都应是 B。
  2. 让 A 的请求晚到并失败,B 已打开后,页面不应被 A 的错误提示覆盖。
  3. B 无权限或加载失败时,明确显示 B 的错误;不能把 A 留在预览区冒充 B。
  4. 在 A 加一条批注再切换 B,取消切换应继续留在 A;选择保存时,应先确认 A 的保存结果,再切换到 B。

排查附件切换,先让“用户选了谁、系统正在加载谁、当前实际显示谁”对应起来,再接入 PDF 查看与编辑。这样遇到错文件、旧错误或修改丢失时,就能沿着具体状态找到问题,而不是把所有失败都归到一个 loading 上。