Google App Engine标准环境中运行Puppeteer生成PDF失败求助

看起来你遇到的核心问题是Puppeteer找不到预安装的Chrome浏览器，而且缓存路径的配置没生效，我来帮你一步步排查和解决：

先梳理下你的当前配置与错误核心 #

你已经做了这些尝试：

• 根目录下的.puppeteerrc.cjs.js配置了缓存目录到node_modules/.puppeteer_cache
• 手动创建了对应的缓存目录
• package.json里的gcp-build脚本执行Chrome安装命令
• Puppeteer启动时添加了GAE必需的--no-sandbox参数

但错误提示显示Puppeteer仍在读取默认路径/root/.cache/puppeteer，说明你的配置文件没被正确识别，且构建阶段的Chrome安装路径和配置没对齐。

具体修复步骤 #

1. 修正配置文件名

Puppeteer的官方配置文件后缀是.cjs，你现在的文件名多了.js后缀，导致Puppeteer无法识别。把文件名改成.puppeteerrc.cjs，内容保持不变：

const {join} = require('path')

/**
 * @type {import("puppeteer").Configuration}
 */
module.exports = {
  cacheDirectory: join(__dirname, 'node_modules', '.puppeteer_cache')
}

2. 调整gcp-build脚本，绑定安装路径

在构建阶段安装Chrome时，要明确指定安装到你的缓存目录，避免路径不一致。修改package.json里的脚本：

"scripts": {
  "start": "node index.js",
  "test": "echo \"Error: no test specified\" && exit 1",
  "dev": "nodemon index.js",
  "gcp-build": "mkdir -p node_modules/.puppeteer_cache && npx @puppeteer/browsers install chrome --cache-dir=node_modules/.puppeteer_cache"
}

这里加了mkdir -p确保缓存目录存在（防止部署时目录缺失），同时用--cache-dir强制Chrome安装到你配置的路径。

3. 启动Puppeteer时指定可执行路径（可选但更稳妥）

为彻底避免路径问题，可以直接指定Chrome的可执行路径。先安装依赖：

npm install @puppeteer/browsers

然后修改PDF生成代码：

const puppeteer = require('puppeteer')
const {executablePath} = require('@puppeteer/browsers')
const path = require('path')

async function generatePDFromUrl(url) {
  // 获取配置的Chrome可执行路径
  const chromePath = await executablePath('chrome', {
    cacheDir: path.join(__dirname, 'node_modules', '.puppeteer_cache')
  })

  const browser = await puppeteer.launch({
    headless: true,
    args: ['--no-sandbox', '--disable-setuid-sandbox'], // 补充参数提升兼容性
    executablePath: chromePath
  })

  const page = await browser.newPage()
  await page.goto(url, { waitUntil: 'networkidle2' })

  const pdfBuffer = await page.pdf({
    format: 'A4',
    printBackground: true,
  })

  await browser.close()
  return pdfBuffer
}

module.exports = { generatePDFromUrl }

4. 检查App Engine运行时配置

确保你的app.yaml配置了足够的资源（Puppeteer需要较多内存）：

runtime: nodejs20
instance_class: F2 # 至少F2级别，避免内存不足

问题根源总结 #

• 配置文件名错误导致Puppeteer读取默认缓存路径
• 构建阶段安装Chrome时未指定路径，导致Chrome安装到默认目录，和你的配置不匹配

按上述步骤调整后，建议先在本地执行npm run gcp-build测试构建流程，确认Chrome安装到指定目录后再部署到GAE。

备注：内容来源于stack exchange，提问作者VSTEAM Education