GCP Cloud Run部署Node.js应用：Playwright运行时未生效问题

你的问题核心出在两个关键环节：

1. 系统依赖未带入最终镜像 #

playwright install-deps 安装的是浏览器运行必需的系统级依赖（如libnss3、libatk1.0-0等），但该命令在production-deps阶段执行后，最终镜像基于base阶段构建，并未继承这些已安装的系统包，导致运行时浏览器无法启动，触发类似「Playwright未安装」的错误。

2. Playwright可能未被包含在生产依赖中 #

如果package.json里playwright被放在devDependencies中，pnpm install --prod不会安装它，此时npx playwright install只是临时下载执行，不会将Playwright核心包和浏览器二进制文件保留到最终镜像的node_modules目录。

具体修复步骤 #

步骤一：调整package.json

将playwright从devDependencies移到dependencies（生产环境需要直接依赖它），示例：

{
  "dependencies": {
    "playwright": "^1.40.0",
    // 其他生产依赖...
  },
  "devDependencies": {
    // 仅保留开发阶段所需的包...
  }
}

修改后重新生成锁文件：

pnpm install

步骤二：修改Dockerfile修复系统依赖问题

推荐采用继承production-deps阶段的方式，直接保留已安装的系统依赖和Playwright：

FROM node:20 as base

RUN corepack enable

# All deps stage
FROM base as deps
WORKDIR /app
ADD package.json pnpm-lock.yaml ./
RUN pnpm install

# Production only deps stage
FROM base as production-deps
WORKDIR /app
ADD package.json pnpm-lock.yaml ./
# 指定浏览器二进制文件安装到node_modules目录，确保能被复制到最终镜像
ENV PLAYWRIGHT_BROWSERS_PATH=./node_modules/playwright/.local-browsers
RUN pnpm install --prod
RUN npx playwright install  # 安装浏览器二进制文件
RUN npx playwright install-deps  # 安装系统级依赖

# Build stage
FROM base as build
WORKDIR /app
COPY --from=deps /app/node_modules /app/node_modules
ADD . .
RUN node ace build --ignore-ts-errors

# Production stage
# 改为基于production-deps构建，直接继承系统依赖和已安装的Playwright
FROM production-deps
ENV NODE_ENV=production
WORKDIR /app
# 无需重复复制node_modules，直接复制构建产物
COPY --from=build /app/build /app
EXPOSE 8080
CMD ["node", "./bin/server.js"]

可选优化：指定安装特定浏览器

如果你的应用只用到某一款浏览器（如Chromium），可以明确指定安装以减少镜像体积：

RUN npx playwright install chromium

验证修复：重新构建镜像并部署到Cloud Run，运行时即可正常加载Playwright和浏览器环境。

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