GitLab CI一次性安装依赖复用 避免重复npm/Playwright安装方案咨询

可以实现依赖持久化避免重复安装，结合自定义预装镜像的方案能彻底解决安装阶段的网络连接故障，具体可选方案如下：

GitLab CI 缓存方案（配置成本最低） #

• 缓存需要同时覆盖三个路径：npm全局缓存、项目node_modules目录、Playwright浏览器存储目录，Linux环境下Playwright默认浏览器存放在~/.cache/ms-playwright，如果自定义了PLAYWRIGHT_BROWSERS_PATH环境变量就按自定义路径缓存，只缓存node_modules依然会触发浏览器下载流程。
• 缓存key必须绑定package-lock.json的文件哈希，锁文件无变更时直接拉取缓存跳过安装，锁文件更新时自动重新安装依赖并刷新缓存，避免版本不一致问题。
• 参考配置：

variables:
  npm_config_cache: "$CI_PROJECT_DIR/.npm"
  PLAYWRIGHT_BROWSERS_PATH: "$CI_PROJECT_DIR/.cache/ms-playwright"

cache:
  key:
    files:
      - package-lock.json
  paths:
    - .npm/
    - node_modules/
    - .cache/ms-playwright/
  policy: pull-push

e2e_test:
  image: node:20-bookworm
  script:
    # 缓存不存在时才执行安装，存在则直接跳过
    - [ -d "node_modules" ] || npm ci
    - [ -d "$PLAYWRIGHT_BROWSERS_PATH" ] || npx playwright install --with-deps
    - npx playwright test

• 注意事项：GitLab CI缓存有默认过期时间，若实例配置了缓存自动清理规则，缓存失效后依然会重新执行安装流程，极端网络场景下还是可能触发连接错误。

预装依赖自定义Docker镜像（稳定性最高，推荐生产环境使用） #

这个方案完全把依赖安装步骤前置到镜像构建阶段，流水线运行时无需执行任何安装命令，从根源规避安装阶段的网络问题。

• 优先基于官方Playwright基础镜像构建，官方镜像已经预装了所有浏览器运行需要的系统依赖、匹配版本的Node环境，不需要自己手动安装libnss、libatk之类的系统库踩坑，注意基础镜像的版本号必须和项目中使用的Playwright版本完全一致。
• 构建镜像时提前执行npm ci完成项目依赖安装，将构建好的镜像推送到项目自带的私有容器仓库即可。
• 参考Dockerfile：

# 选择官方发布的对应版本Playwright基础镜像，tag必须和本地项目安装的Playwright版本完全一致，比如v1.46.0-jammy
FROM playwright:v1.46.0-jammy
WORKDIR /app
# 先拷贝锁文件，最大化利用Docker层缓存
COPY package*.json ./
RUN npm ci
COPY . .

• CI侧配置极简，直接拉取预装镜像执行测试命令即可：

e2e_test:
  image: 你的项目私有容器仓库路径/playwright-env:v1.46.0
  script:
    - npx playwright test

• 注意事项：镜像不要用latesttag，每次升级Playwright版本、变更项目npm依赖时，重新构建对应版本tag的镜像推送即可，保证本地开发和CI运行环境版本完全一致。

临时兜底优化方案 #

如果暂时不想调整缓存或镜像配置，可以通过配置国内镜像源降低安装阶段的连接失败概率：

variables:
  npm_config_registry: "https://registry.npmmirror.com"
  PLAYWRIGHT_DOWNLOAD_HOST: "https://npmmirror.com/mirrors/playwright"

该方案不需要调整现有流程，但是没有从根本上解决重复安装、网络波动影响的问题，仅适合临时过渡使用。

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