AWS Lambda运行Puppeteer时出现Page.printToPDF打印失败错误求助

1. 移除冲突的页面尺寸配置 #

你同时设置了format: 'A4'和自定义的width/height，这会导致Chromium打印引擎的尺寸逻辑冲突——A4标准尺寸为21cm×29.7cm，和你指定的27.3cm×30.61cm不匹配，这很可能是触发打印失败的核心原因。修改配置时二选一：

// 方案1：使用标准A4格式，删除自定义宽高
const pdf = await page.pdf({
  scale: body.pdfCoordinator?.scale,
  margin: body.pdfCoordinator?.margin || { top: '9.5mm', bottom: '9.5mm', left: '6mm', right: '6mm' },
  format: 'A4',
  landscape: body.pdfCoordinator?.landscape || false,
  printBackground: true,
  displayHeaderFooter: body.pdfCoordinator?.displayHeaderFooter !== undefined ? body.pdfCoordinator.displayHeaderFooter : true,
  headerTemplate: getHeaderFooter(),
  footerTemplate: getHeaderFooter(),
})

// 方案2：使用自定义尺寸，删除format配置
const pdf = await page.pdf({
  scale: body.pdfCoordinator?.scale,
  margin: body.pdfCoordinator?.margin || { top: '9.5mm', bottom: '9.5mm', left: '6mm', right: '6mm' },
  landscape: body.pdfCoordinator?.landscape || false,
  printBackground: true,
  displayHeaderFooter: body.pdfCoordinator?.displayHeaderFooter !== undefined ? body.pdfCoordinator.displayHeaderFooter : true,
  headerTemplate: getHeaderFooter(),
  footerTemplate: getHeaderFooter(),
  width: '27.3cm',
  height: '30.61cm',
})

2. 排查目标页面的特殊内容 #

既然仅某一处触发错误，优先检查该页面的特殊元素：

• 确认是否存在超大尺寸的图片/元素，超出页面范围导致渲染溢出；
• 强制等待页面资源完全加载后再打印，即使你认为前置步骤正常：

await page.waitForLoadState('networkidle0'); // 等待网络空闲，所有资源加载完成
// 或等待页面核心元素渲染完毕
await page.waitForSelector('#page-main-content');

• 检查是否有position: fixed元素和页眉页脚区域重叠，临时移除这类元素的fixed样式再尝试打印。

3. 调整Lambda资源配置 #

Lambda默认的内存/CPU可能不足以支撑复杂页面的PDF渲染：

• 将Lambda内存至少提升至1024MB（Lambda的CPU分配随内存比例增长）；
• 延长超时时间到30秒以上，避免渲染过程被强制终止。

4. 捕获详细错误上下文 #

在page.pdf调用处添加错误捕获，打印页面URL、配置参数等信息，帮助精准定位问题：

try {
  const pdf = await page.pdf({
    // 你的PDF配置
  });
} catch (error) {
  console.error('PDF生成失败详情:', {
    pageUrl: page.url(),
    pdfConfig: {
      scale: body.pdfCoordinator?.scale,
      margin: body.pdfCoordinator?.margin || { top: '9.5mm', bottom: '9.5mm', left: '6mm', right: '6mm' },
      format: 'A4',
      landscape: body.pdfCoordinator?.landscape || false,
      displayHeaderFooter: body.pdfCoordinator?.displayHeaderFooter !== undefined ? body.pdfCoordinator.displayHeaderFooter : true,
      width: '27.3cm',
      height: '30.61cm',
    },
    errorStack: error.stack
  });
  throw error;
}

5. 验证页眉页脚模板 #

检查getHeaderFooter()返回的HTML模板是否存在语法错误，Chromium对页眉页脚的HTML/CSS支持有限，避免使用复杂样式或JS，尽量用极简静态结构：

function getHeaderFooter() {
  return `
    <div style="font-size: 10px; text-align: center; width: 100%; padding: 2mm;">
      页眉/页脚内容
    </div>
  `;
}

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