You need to enable JavaScript to run this app. 如何在浏览器展示Express/PDFKit生成的API返回的PDF
优惠活动
大模型
产品
解决方案
定价
更多

如何在浏览器展示Express/PDFKit生成的API返回的PDF

核心错误定位

参数传递链路的基础错误

  • 后端定义的是GET /create_pdf路由,却试图从req.body读取foo、bar参数:GET请求不存在标准请求体,Express默认也不会解析GET请求的body内容,这两个参数实际根本获取不到。
  • 前端调用GET接口时,把参数放在了axios的data字段里:axios中data仅适配POST、PUT这类携带请求体的请求,GET请求的参数需要放在params字段,才会正确拼接为URL查询参数传到后端。

二进制流处理的认知偏差

PDF属于二进制格式文件,当前实现从后端生成到前端接收的全链路,都把PDF当成了普通文本/JSON处理,这是控制台输出乱码、打开窗口空白的根本原因:

  • 后端没有设置对应响应头,没有告知客户端返回内容是PDF格式的二进制流。
  • 前端axios默认会把响应内容按文本/JSON格式解析,没有指定responseType: 'blob',直接破坏了PDF的二进制结构,就算拿到原始字节序列也没法正常渲染。
  • window.open方法仅能接收可访问的URL地址,无法直接将原始PDF字符串作为参数传入,自然会打开空白页。
修正后的完整实现

后端Express + PDFKit 修正代码

// GET请求从query字段取参数,不要读取body
router.get("/create_pdf", (req, res) => {
  const foo = req.query.foo;
  const bar = req.query.bar;

  // 原有Postgres查询逻辑保持不变
  // ...

  // 关键:设置正确的响应头
  res.setHeader('Content-Type', 'application/pdf');
  // inline表示在浏览器直接打开PDF,替换为attachment则触发下载,可自定义文件名
  res.setHeader('Content-Disposition', 'inline; filename=generated.pdf');

  const doc = new PDFDocument();
  doc.pipe(res);
  doc.fontSize(25).text("Just a header", 100, 80);

  // 原有PDF内容生成逻辑保持不变
  // ...

  doc.end();
})

前端Vue + Axios 修正代码

print: function() {
  const params = {foo: "foo", bar: "bar"};
  this.axios({
    method: "get",
    url: "get_recipe_as_pdf",
    // GET请求用params传参
    params: params,
    // 关键:指定响应类型为Blob,避免将二进制PDF解析成文本
    responseType: 'blob',
  })
    .then((response) => {
      // 将二进制流转换为浏览器可访问的临时URL
      const pdfBlobUrl = URL.createObjectURL(new Blob([response.data], {type: 'application/pdf'}));
      // 新窗口打开渲染PDF
      window.open(pdfBlobUrl, '_blank');
      // 页面加载完成后回收临时URL,避免内存泄漏
      window.addEventListener('load', () => {
        URL.revokeObjectURL(pdfBlobUrl);
      });
    })
    .catch(() => {
      // 原有错误处理逻辑
    });
},
可选简化方案

如果传递的参数长度不大,完全可以绕开axios调用,直接用GET请求带参数打开PDF路由,只要后端正确设置响应头,浏览器会自动完成PDF的渲染,代码更简洁,也不会出现流解析的问题:

print: function() {
  // 直接拼接查询参数,触发浏览器原生打开PDF的逻辑
  const pdfUrl = `/create_pdf?foo=foo&bar=bar`;
  window.open(pdfUrl, '_blank');
}

注意:URL存在长度限制(不同浏览器/服务器的限制通常在2k-8k字符之间),如果传递的参数内容很长、比如包含大段配方文本,就还是使用Blob流的方案,此时把后端路由改为POST方法,参数从req.body读取即可,其余响应头、responseType的配置保持不变。

内容的提问来源于stack exchange,提问作者AndreasInfo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 09:15:08