如何在浏览器展示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
相关产品推荐
相关产品推荐

