使用jsreport-core与jsreport-chrome-pdf生成超大型表格PDF时遭遇Puppeteer Protocol error (Page.printToPDF): Printing failed问题求助

我完全懂你现在的头疼——1400页的纯文本表格转HTML秒成，但Puppeteer一渲染PDF就报错，这明显是Chrome的PDF打印引擎扛不住超大DOM的资源压力。下面是几个经过验证的解决方案，按优先级排序：

1. 分段生成PDF后合并（最推荐） #

既然小片段PDF生成没问题，我们可以把超大表格拆成多个小批次，分别渲染成PDF片段，最后合并成完整文件。这种方式能把单个PDF的渲染压力降到最低，避免Chrome因内存过载崩溃。

实现思路： #

• 把完整数据源拆分成多个子数组，比如按每页60行计算，每100页对应一个子数据集
• 循环调用jsreport生成每个子数据集的PDF片段
• 用pdf-lib把所有PDF片段合并成一个文件

示例代码片段： #

const { PDFDocument } = require('pdf-lib');
const fs = require('fs').promises;

// 1. 拆分数据源：originalData是完整表格数据，每页60行
const pageRowCount = 60;
const splitData = [];
for (let i = 0; i < originalData.length; i += pageRowCount) {
  splitData.push(originalData.slice(i, i + pageRowCount));
}

// 2. 批量生成PDF片段
const pdfBuffers = [];
for (const chunk of splitData) {
  const report = await jsreport.render({
    template: {
      content: yourHandlebarsTemplate, // 你的Handlebars模板内容
      engine: 'handlebars',
      recipe: 'chrome-pdf'
    },
    data: { tableData: chunk }
  });
  pdfBuffers.push(report.content);
}

// 3. 合并所有PDF片段
const mergedPdf = await PDFDocument.create();
for (const buffer of pdfBuffers) {
  const pdf = await PDFDocument.load(buffer);
  const pages = await mergedPdf.copyPages(pdf, pdf.getPageIndices());
  pages.forEach(page => mergedPdf.addPage(page));
}

const mergedBuffer = await mergedPdf.save();
await fs.writeFile('final-large-table.pdf', mergedBuffer);

2. 进一步优化Puppeteer的启动参数和资源配置 #

你当前的参数已经加了不少优化项，但可以补充几个针对大内存场景的关键参数：

.use(require('@jsreport/jsreport-chrome-pdf')({ 
  timeout: 600000, 
  launchOptions: { 
    headless: 'new', // 用新版无头模式，资源占用更低
    args: [ 
      '--disable-dev-shm-usage', // 避免共享内存不足（Linux/容器环境常见问题）
      '--no-sandbox', // 可信环境下关闭沙箱，减少资源开销
      '--disable-setuid-sandbox',
      '--max-old-space-size=8192', // 给Chrome分配8GB内存（根据服务器配置调整）
      '--disable-extensions',
      '--disable-background-networking',
      '--hide-scrollbars',
      '--mute-audio',
      '--disable-gpu'
    ] 
  } 
}))

同时调整jsreport的worker配置，避免过多worker抢占资源：

const jsreport = require('@jsreport/jsreport-core')({ 
  allowLocalFilesAccess: true, 
  reportTimeout: 600000, 
  templatingEngines: { timeout: 600000 }, 
  sandbox: { cache: { max: 500 } }, 
  workers: { numberOfWorkers: 2 } // 减少worker数量，给每个worker预留更多内存
});

3. 跳过HTML渲染，直接用PDF生成库构建表格 #

如果分段生成还是有问题，可以绕过HTML→PDF的转换环节，用专门的PDF生成库（比如pdfmake）直接构建表格。这种方式不依赖Chrome，内存占用更低，生成速度也更快。

简单示例（pdfmake）： #

const pdfMake = require('pdfmake');
const fs = require('fs');

// 配置字体（按需调整）
const fonts = {
  Roboto: {
    normal: 'fonts/Roboto-Regular.ttf',
    bold: 'fonts/Roboto-Medium.ttf'
  }
};
const printer = new pdfMake(fonts);

// 构建pdfmake的表格数据结构
const tableRows = [['列1', '列2', '列3', '列4', '列5', '列6', '列7']]; // 表头
originalData.forEach(item => {
  tableRows.push([item.col1, item.col2, item.col3, item.col4, item.col5, item.col6, item.col7]);
});

const docDefinition = {
  content: [
    {
      table: {
        headerRows: 1,
        widths: ['*', '*', '*', '*', '*', '*', '*'], // 列宽自适应
        body: tableRows
      },
      layout: 'headerLineOnly' // 可选表格样式
    }
  ],
  pageSize: 'A4',
  pageMargins: [40, 60, 40, 60]
};

const pdfDoc = printer.createPdfKitDocument(docDefinition);
pdfDoc.pipe(fs.createWriteStream('direct-large-table.pdf'));
pdfDoc.end();

4. 最后尝试：简化HTML表格的渲染压力 #

虽然你已经删除了CSS和辅助函数，但可以再检查几点：

• 确保用原生<table>标签，不要用<div>模拟表格——Chrome对原生表格的渲染优化更好
• 移除单元格内多余的DOM嵌套，比如不必要的<div>或<span>
• 尽量用极简的CSS，避免复杂选择器或动画效果

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