已部署应用中Playwright提示需重新安装问题咨询

核心原因 #

Playwright的npm包仅包含核心运行库，浏览器二进制文件（Chromium、Firefox、WebKit等）不会随npm install自动下载。本地正常是因为你之前手动执行过npx playwright install，或初始化项目时自动完成了浏览器安装，但部署环境只执行了npm install，缺少浏览器文件，因此触发该提示。

常见部署场景问题 #

• 缓存或步骤遗漏：部分部署工具（如Docker、CI/CD流水线）会缓存node_modules，或跳过浏览器安装步骤；使用npm ci时，仅严格按package-lock.json安装依赖，同样不会自动下载浏览器。
• 生产环境依赖过滤：若Playwright被放在devDependencies中，部署时执行npm install --production会跳过开发依赖，可能导致核心库不完整（可排查package.json配置）。
• 权限不足：部署环境的用户无权限下载或写入浏览器二进制文件的存储目录（默认是node_modules/playwright/.cache），即使执行安装命令也可能静默失败。

解决方法 #

• 在部署脚本中明确添加浏览器安装步骤，放在npm install之后：

  npm install
  npx playwright install
  

• Docker环境可在Dockerfile中加入：

  RUN npm install
  RUN npx playwright install chromium  # 可指定仅安装所需浏览器，减少镜像体积
  

• 调整依赖配置：若Playwright是业务必需，将其从devDependencies移至dependencies，避免生产环境被忽略。
• 检查权限：确保部署用户对项目目录及Playwright浏览器缓存目录拥有读写权限。

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