Node.js使用PDFKit生成PDF文件后无法打开的问题求助

本地生成PDF的修复方案 #

先排查本地生成文件的问题，确保基础逻辑正确：

1. 更新PDFKit到最新版本
   旧版本可能存在流处理bug，执行命令更新：

npm install pdfkit@latest

2. 调整代码执行顺序
   将内容写入操作放在pipe之后，能避免流初始化不完整的问题，同时监听finish事件更准确（close事件是流关闭时触发，finish是所有数据写入完成时触发）：

const PDFDocument = require('pdfkit');
const fs = require('fs');

const doc = new PDFDocument();
const writeStream = fs.createWriteStream('MyTest.pdf');

// 先建立管道，再写入内容
doc.pipe(writeStream);
doc.text('Test');
doc.end();

writeStream.on('finish', () => {
  console.log('PDF生成完成');
});

3. 检查文件完整性
   用PDF工具验证文件是否损坏，比如用pdftk执行：

pdftk MyTest.pdf dump_data

如果能输出PDF的元数据，说明文件本身正常，问题可能出在客户端打开环节；如果报错，说明文件生成过程中损坏。

服务器端流式传输给客户端的正确写法 #

你的核心需求是流式传输给客户端下载，这时候必须正确设置响应头，同时直接将PDF流 pipe 到响应对象，不需要本地文件中转：

const express = require('express');
const PDFDocument = require('pdfkit');
const app = express();

app.get('/download-pdf', (req, res) => {
  // 关键：设置正确的响应头，让客户端识别PDF文件
  res.setHeader('Content-Type', 'application/pdf');
  res.setHeader('Content-Disposition', 'attachment; filename="MyTest.pdf"');

  const doc = new PDFDocument();
  // 直接将PDF流导向响应对象
  doc.pipe(res);
  doc.text('Test');
  doc.end();
});

app.listen(3000, () => {
  console.log('服务器运行在3000端口');
});

额外排查点 #

• 字体问题：如果使用自定义字体，确保字体文件路径正确且加载成功，可临时改用默认字体测试：doc.font('Helvetica').text('Test');
• 大PDF场景：如果生成大体积PDF，避免在内存中缓存全部内容，保持流式写入的方式，防止内存溢出导致文件损坏。

内容的提问来源于stack exchange，提问作者NicolaLovo