如何配置Dockerfile适配Puppeteer 21.7？Node.js16容器报错排查

在Node.js 16的Docker容器中使用Puppeteer 21.7时，持续出现以下报错：

Error: Could not find Chrome (ver. 119.0.6045.105). This can occur if either

1. You did not perform an installation before running the script (e.g. npx puppeteer browsers install chrome) or
2. Your cache path is incorrectly configured (which is: /usr/src/app/.cache/puppeteer).

当前使用的Dockerfile如下：

# Use the official Node.js image.
FROM node:16-slim

# Install required system dependencies
RUN apt-get update && \
apt-get install -yq gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 \ libgbm-dev libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 \ libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1  \ libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 \ ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget 

# Create and change to the app directory.
WORKDIR /usr/src/app

# Create a directory for the Puppeteer cache in the root project.
RUN mkdir /.cache

# Copy the .puppeteerrc.cjs file into the Docker image.
COPY .puppeteerrc.cjs /usr/src/app/.puppeteerrc.cjs

# Copy application dependency manifests to the container image.
# A wildcard is used to ensure copying both package.json AND package-lock.json (when available).
# Copying this first prevents re-running npm install on every code change.
COPY package*.json ./

# Install production dependencies.
RUN npm install --only=production

# Install Puppeteer.
RUN npm install puppeteer
RUN npx puppeteer install


# Set the environment variable for Puppeteer's download path.
ENV PUPPETEER_DOWNLOAD_PATH=/.cache/puppeteer

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD [ "node", "index.js" ]

你的Dockerfile存在几个关键配置问题，调整后即可解决找不到Chrome的报错：

1. 环境变量设置时机错误 #

PUPPETEER_DOWNLOAD_PATH必须在执行npm install puppeteer之前设置，否则安装过程中Chrome会被下载到默认路径/usr/src/app/.cache/puppeteer，但运行时你指定了新路径，导致Puppeteer找不到已安装的Chrome。

调整：将ENV PUPPETEER_DOWNLOAD_PATH=/.cache/puppeteer移到所有npm安装命令之前。

2. 权限配置缺失 #

你创建了/.cache目录，但默认的Node用户没有该目录的读写权限，会导致Chrome下载失败或运行时无法访问。

调整：创建目录时同时设置权限：

RUN mkdir /.cache && chown -R node:node /.cache

同时建议切换到非root用户运行容器，避免后续权限问题：

USER node

3. Puppeteer安装命令冗余 #

npm install puppeteer会自动触发Chrome的安装，不需要再单独执行npx puppeteer install，这条命令属于冗余操作，可以直接删除。

4. 系统依赖优化 #

node:16-slim镜像中的部分依赖已过时（比如libappindicator1在新版Debian中已被替换），建议更新依赖列表，同时添加--no-install-recommends参数减少镜像体积：

RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    fonts-liberation \
    libasound2 \
    libatk-bridge2.0-0 \
    libatk1.0-0 \
    libc6 \
    libcairo2 \
    libcups2 \
    libdbus-1-3 \
    libexpat1 \
    libfontconfig1 \
    libgbm-dev \
    libgcc1 \
    libglib2.0-0 \
    libgtk-3-0 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libstdc++6 \
    libx11-6 \
    libx11-xcb1 \
    libxcb1 \
    libxcomposite1 \
    libxcursor1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxi6 \
    libxrandr2 \
    libxrender1 \
    libxss1 \
    libxtst6 \
    lsb-release \
    wget \
    xdg-utils \
    && rm -rf /var/lib/apt/lists/*

最终调整后的Dockerfile #

# Use the official Node.js image.
FROM node:16-slim

# Install required system dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    fonts-liberation \
    libasound2 \
    libatk-bridge2.0-0 \
    libatk1.0-0 \
    libc6 \
    libcairo2 \
    libcups2 \
    libdbus-1-3 \
    libexpat1 \
    libfontconfig1 \
    libgbm-dev \
    libgcc1 \
    libglib2.0-0 \
    libgtk-3-0 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libstdc++6 \
    libx11-6 \
    libx11-xcb1 \
    libxcb1 \
    libxcomposite1 \
    libxcursor1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxi6 \
    libxrandr2 \
    libxrender1 \
    libxss1 \
    libxtst6 \
    lsb-release \
    wget \
    xdg-utils \
    && rm -rf /var/lib/apt/lists/*

# Create cache directory and set permissions
RUN mkdir /.cache && chown -R node:node /.cache

# Set Puppeteer environment variable BEFORE installing
ENV PUPPETEER_DOWNLOAD_PATH=/.cache/puppeteer

# Create and change to the app directory.
WORKDIR /usr/src/app

# Copy configuration files first
COPY .puppeteerrc.cjs ./
COPY package*.json ./

# Install dependencies as non-root user
USER node
RUN npm install --only=production

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD [ "node", "index.js" ]

额外检查项 #

• 确认.puppeteerrc.cjs中没有覆盖cacheDirectory或executablePath，如果有，需和环境变量保持一致。
• 运行Puppeteer时，建议添加无沙箱参数（容器中通常缺少完整沙箱环境）：

const browser = await puppeteer.launch({
  args: ['--no-sandbox', '--disable-setuid-sandbox']
});

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