Puppeteer本地Docker运行正常，部署Cloud Run失败的解决咨询

核心问题分析 #

本地Docker运行正常但Cloud Run报错，本质是两者环境差异：Cloud Run采用non-root用户运行、缺少部分系统依赖、沙箱机制限制，导致Chrome无法启动或被定位到。

具体解决方案 #

1. 调整Dockerfile，确保依赖与Chrome版本匹配 #

使用node:18-slim作为基础镜像（兼顾体积与兼容性），安装Chrome运行必需的系统库，同时确保Chrome版本与Puppeteer版本严格对应（你的报错版本为113.0.5672.63，需匹配对应版本的Puppeteer）。

示例Dockerfile：

# 基础镜像
FROM node:18-slim

# 设置工作目录
WORKDIR /app

# 安装Chrome运行依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxfixes3 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpangocairo-1.0-0 \
    libx11-xcb1 \
    wget \
    && rm -rf /var/lib/apt/lists/*

# 安装指定版本的Chrome（与Puppeteer依赖版本一致）
RUN wget -q https://dl.google.com/linux/chrome/deb/pool/main/g/google-chrome-stable/google-chrome-stable_113.0.5672.63-1_amd64.deb \
    && apt-get install -y ./google-chrome-stable_113.0.5672.63-1_amd64.deb \
    && rm google-chrome-stable_113.0.5672.63-1_amd64.deb

# 设置环境变量，指定Chrome可执行路径
ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable
ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true

# 复制package文件并安装依赖
COPY package*.json ./
RUN npm install

# 复制应用代码
COPY . .

# 创建非root用户并设置权限（适配Cloud Run运行规则）
RUN groupadd -r pptruser && useradd -r -g pptruser -G audio,video pptruser
RUN mkdir -p /home/pptruser/Downloads && chown -R pptruser:pptruser /home/pptruser
RUN chown -R pptruser:pptruser /app

# 切换到非root用户
USER pptruser

# 暴露端口（根据你的服务端口调整）
EXPOSE 3000

# 启动服务
CMD ["npm", "start"]

2. 配置Puppeteer启动参数 #

在代码中添加适配Cloud Run环境的启动参数，禁用沙箱、调整资源限制：

const puppeteer = require('puppeteer');

async function generatePdf(htmlContent) {
  const browser = await puppeteer.launch({
    headless: 'new', // Chrome 112+推荐的新无头模式
    args: [
      '--no-sandbox', // Cloud Run不支持完整沙箱，必须禁用
      '--disable-setuid-sandbox',
      '--disable-dev-shm-usage', // 避免/dev/shm空间不足导致Chrome崩溃
      '--disable-gpu', // 无GPU环境下禁用
      '--window-size=1920,1080' // 固定窗口尺寸保证PDF渲染一致性
    ],
    executablePath: process.env.PUPPETEER_EXECUTABLE_PATH, // 使用系统安装的Chrome
  });

  const page = await browser.newPage();
  await page.setContent(htmlContent, { waitUntil: 'networkidle0' });
  const pdfBuffer = await page.pdf({ format: 'A4' });
  
  await browser.close();
  return pdfBuffer;
}

3. 验证Cloud Build构建过程 #

确保Cloud Build在构建镜像时完整执行所有步骤：

• 不要在npm install时跳过Puppeteer的依赖安装
• 若网络受限导致Chrome安装包下载失败，可提前将Chrome包放入项目目录，改用本地路径安装

4. Cloud Run服务配置调整 #

在Cloud Run控制台部署时：

• 分配足够的CPU和内存（建议至少1CPU、512MB内存，Chrome渲染PDF需要一定资源）
• 确认服务的环境变量与Dockerfile中设置的一致（如PUPPETEER_EXECUTABLE_PATH）

关键注意点 #

• Puppeteer版本必须与Chrome版本严格匹配，可通过npm view puppeteer versions查看对应版本的Chrome依赖
• 绝对不能以root用户运行服务，Cloud Run强制要求non-root，否则会触发权限错误
• --disable-dev-shm-usage参数必须添加，因为Cloud Run的/dev/shm空间有限，会导致Chrome启动失败

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