Docker中Playwright突然失效：浏览器可执行文件不存在

问题背景 #

此前服务运行正常，当前在Google Cloud Run部署的Docker容器中运行Express集成Playwright的服务，期望以有界面模式运行（当前任何模式均可接受），但启动浏览器时触发报错。

报错信息 #

browserType.launch: Executable doesn't exist at /home/.cache/ms-playwright/chromium-1124/chrome-linux/chrome
╔═════════════════════════════════════════════════════════════════════════╗
║ Looks like Playwright Test or Playwright was just installed or updated. ║
║ Please run the following command to download new browsers:              ║
║                                                                         ║
║     npx playwright install                                              ║
║                                                                         ║
║ <3 Playwright Team                                                      ║
╚═════════════════════════════════════════════════════════════════════════╝

原配置信息 #

原Dockerfile #

# Start from a base Node.js image
FROM node:latest

# Install necessary packages: XVFB and fonts
RUN apt-get update \
    && apt-get install -y \
        xvfb \
        x11-xkb-utils \
        xfonts-100dpi \
        xfonts-75dpi \
        xfonts-scalable \
        x11-apps \
        clang \
        libdbus-1-3 \
        libatk1.0-0 \
        libatk-bridge2.0-0 \
        libcups2 \
        libatspi2.0-0 \
        libxcomposite1 \
        libxdamage1 \
        libgbm1 \
        libxkbcommon0 \
        libasound2 \
    && apt-get clean

# Set display environment variable for XVFB
ENV DISPLAY=:99

# Create a working directory
WORKDIR /app

# Copy package.json and package-lock.json
COPY package*.json ./

# Install dependencies
RUN npm install

# Install Playwright browsers
RUN npx playwright install

# Copy the rest of the application code
COPY . .

# Expose the port your app runs on
EXPOSE 3000

# Run XVFB, then start your Express application
CMD xvfb-run --server-args="-screen 0 1024x768x24" node index.js

核心依赖与代码 #

• package.json中Playwright版本："playwright": "^1.44.1"
• index.js核心代码：

const { chromium } = require('playwright');
const browser = await chromium.launch({ headless: false });

已尝试的解决方案 #

• 使用Zenika提供的镜像及对应Dockerfile：

FROM zenika/alpine-chrome:with-node

ENV PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD 1
ENV PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium-browser
WORKDIR /usr/src/app
COPY --chown=chrome package.json package-lock.json ./
RUN npm install
ENTRYPOINT ["tini", "--"]

• 参考Playwright browsers相关教程
• 切换至Node.js 14.10版本
• 指定executablePath为/usr/bin/chromium-browser
• 其他多种微调方案，但问题仍未解决

可行解决方案 #

方案1：修正Dockerfile的权限与路径配置 #

针对Google Cloud Run的运行环境特性，调整Dockerfile以确保浏览器安装路径可访问、权限合规：

FROM node:20-slim

# 安装Playwright运行必需的精简系统依赖
RUN apt-get update && apt-get install -y \
    xvfb \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpangocairo-1.0-0 \
    libgtk-3-0 \
    && rm -rf /var/lib/apt/lists/*

# 创建非root用户（Cloud Run推荐非root运行）
RUN useradd -m appuser
USER appuser

# 指定Playwright浏览器缓存目录为当前用户可访问路径
ENV PLAYWRIGHT_BROWSERS_PATH=/home/appuser/.cache/ms-playwright

WORKDIR /home/appuser/app

# 复制依赖文件并安装生产依赖
COPY --chown=appuser package*.json ./
RUN npm ci --only=production

# 安装对应版本的Chromium浏览器及依赖
RUN npx playwright install chromium --with-deps

# 复制应用代码
COPY --chown=appuser . .

EXPOSE 3000

# 启动命令：先启动XVFB再运行应用
CMD xvfb-run --server-args="-screen 0 1024x768x24" node index.js

方案2：直接使用Playwright官方镜像 #

利用官方镜像自带的完整依赖与浏览器环境，避免手动配置的问题：

FROM mcr.microsoft.com/playwright:v1.44.1-jammy

WORKDIR /app

# 复制依赖文件并安装
COPY package*.json ./
RUN npm ci --only=production

# 复制应用代码
COPY . .

EXPOSE 3000

# 如需有界面模式，添加XVFB启动命令；无需则可直接运行
CMD xvfb-run --server-args="-screen 0 1024x768x24" node index.js

方案3：调整Chromium启动参数 #

在代码中明确指定浏览器路径，或切换至Cloud Run更友好的无头模式：

const { chromium } = require('playwright');

// 方式1：指定Playwright安装的Chromium路径
const browser = await chromium.launch({
  headless: false,
  executablePath: process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH || '/home/appuser/.cache/ms-playwright/chromium-1124/chrome-linux/chrome'
});

// 方式2：使用Playwright新无头模式（无需XVFB，适合Cloud Run）
// const browser = await chromium.launch({ headless: 'new' });

关键注意点 #

1. 构建阶段完成浏览器安装：Cloud Run容器文件系统是临时的，必须在Dockerfile构建阶段完成浏览器下载，避免运行时丢失。
2. 非root用户运行：Cloud Run推荐使用非root用户，确保浏览器安装路径对运行用户有读写权限。
3. 版本严格匹配：Playwright版本与安装的浏览器版本必须对应，使用npx playwright install chromium会自动安装适配版本。
4. 精简系统依赖：仅保留Playwright运行必需的系统包，减少镜像大小同时避免冲突。

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