React 下载填写后的 PDF,为什么拿到的还是原模板?

0 阅读5分钟

申请表已经在页面里填完,点击“下载”却又拿到一份空白表。这类问题先别急着改表单字段:检查下载按钮究竟下载了什么。

如果按钮仍指向最初的 template.pdf,或重新请求了原文件地址,它得到的就是原模板。要交付填写后的副本,应从当前 PDF 实例导出文档数据,再触发下载。React 里显示了“提交成功”,也不代表这些值已经写进 PDF。

先确认用户填的是 PDF 字段

React 页面上的 <input>、PDF 里的表单域和盖在页面上的文字,是三种不同的数据。把网页输入框里的姓名更新到 useState,不会自动更新 PDF;在空白处添加一段文字,也不等于创建了可继续填写的表单域。

使用 ComPDF Web SDK 填写已有申请表时,先确认文件包含适用的 AcroForm 字段。可以按表单填写指南点击字段输入内容,完成后点一下 PDF 页面空白处,提交当前字段的修改。

如果原文件只有横线,没有字段,应先决定:这份文件只需要填一次,还是要制作一份可重复分发的表单模板。后者需要创建字段;本文处理的是“已有字段、填写后下载”的路径,不把普通页面输入框当成 PDF 字段。

下载地址不同,拿到的文件就可能不同

路径示意:从当前 PDF 实例导出,重新打开下载副本确认。

下载当前实例,而不是再次请求原地址

下面的按钮用于已经初始化、并加载完文档的 ComPDF 实例。父组件在 documentLoaded 事件后把 documentViewer 和 loaded=true 传进来;切换文档时先设回未就绪。完整资源部署和许可配置可按React 接入步骤准备。

import { useState } from "react";

export function FilledPdfDownload({ documentViewer, loaded }) {
  const [exporting, setExporting] = useState(false);
  const [message, setMessage] = useState("");

  async function downloadFilledPdf() {
    if (!loaded || !documentViewer || exporting) return;
    setExporting(true);
    setMessage("");

    try {
      const doc = documentViewer.getDocument();
      const data = await doc.getFileData();
      if (!data || data.byteLength === 0) {
        throw new Error("没有取得 PDF 数据,请检查文档是否已就绪。");
      }

      const blob = new Blob([data], { type: "application/pdf" });
      const url = URL.createObjectURL(blob);
      const link = document.createElement("a");
      link.href = url;
      link.download = "application-filled.pdf";
      document.body.appendChild(link);
      link.click();
      link.remove();
      // 给浏览器消费下载地址的机会,再释放临时 URL。
      setTimeout(() => URL.revokeObjectURL(url), 1000);
      setMessage("已发起下载,请打开下载文件核对填写结果。");
    } catch (error) {
      setMessage(error instanceof Error ? error.message : "导出失败,请重试。");
    } finally {
      setExporting(false);
    }
  }

  return (
    <section>
      <p>填完最后一个字段后,先点一下 PDF 页面空白处。</p>
      <button
        type="button"
        disabled={!loaded || exporting}
        onClick={downloadFilledPdf}
      >
        {exporting ? "正在导出…" : "下载填写后的 PDF"}
      </button>
      <p role="status">{message}</p>
    </section>
  );
}

关键调用是 documentViewer.getDocument().getFileData(),与保存文档指南一致。不要把 getFileData() 换成 fetch(initialDoc):后者重新下载原地址,与当前实例里用户做了什么没有必然联系。

这段代码展示导出按钮的接法,不是包含初始化、文件权限和服务器存储的完整应用。它根据当前文档数据创建 Blob;设置 application/pdf 只声明类型,不证明字段已经正确保存。文件内容仍要通过重新打开检查。

父组件需要处理的两个时机

文档何时可操作。 实例初始化完成与文件加载完成不是同一时刻。以当前版本的 documentLoaded 事件设置就绪状态,加载失败则显示错误,不要让用户面对一直可点击的下载按钮。

导出时是否允许换文件。 示例面向单份申请表。若页面还有附件切换、重新上传或模板版本选择,导出期间应冻结当前任务或明确捕获所需文档版本,防止按钮名称、当前选中项与导出对象不一致。不要把上一份文档的就绪状态沿用给下一份。

需要服务器归档时,再把同一份导出的 Blob 上传到自己的接口。只有服务端确认保存成功并记录对应申请与版本,页面才能显示“已归档”;浏览器开始下载与服务器保存是两个动作。

用自己的申请表检查这五件事

  1. 填写一处文字、一个允许为零的数值,以及一组选项;最后一个字段填完后点页面空白处,再导出。
  2. 关闭预览,打开刚下载的 application-filled.pdf,不要误开原模板;检查文字、零值和选项是否都在。
  3. 如果接收人还要继续填写,确认字段仍可选中和修改。需要保留字段时不要在这条导出路径上默认执行扁平化。
  4. 输入较长文字,检查重开后是否溢出、被裁切或显示不全;有字段值不代表读者能看见完整内容。
  5. 在实际接收方使用的阅读器中再打开一次;如果还有服务器保存,下载归档版本再做同样核对。

若重开文件是空白,依次核对“是否真正写入 PDF 字段 → 当前字段是否提交 → 是否从当前实例导出 → 是否打开了正确副本”。这比看到空白后就重复下载、重新填写,更容易定位问题。

React 负责就绪状态、按钮交互和业务提交,ComPDF 负责 PDF 字段操作与文档导出。先把一份申请表的填写、导出、重开检查做清楚,再增加上传归档或多附件功能,用户拿到的才是自己刚填过的文件。