自动化测试 / 系统课时
接入持续集成流程
接入持续集成流程
将 Playwright 接入持续集成后,每次提交或合并请求都可以在干净环境中重新安装依赖、准备浏览器、执行端到端测试,并保存失败证据和测试报告。本节以 GitHub Actions 为例搭建一条可直接运行的基础流水线。
学习目标
- 在 CI 中正确安装 Node.js 依赖和 Playwright 浏览器依赖
- 在代码推送和合并请求时自动执行 Playwright 测试
- 无论测试成功还是失败,都保留可供排查的 HTML 报告
明确流水线需要完成什么
一条最小可用的 Playwright CI 流程应依次完成代码检出、Node.js 环境准备、依赖安装、浏览器及系统依赖安装、测试执行和报告保存。CI Runner 通常是临时环境,因此不能假设浏览器或 node_modules 已经存在。

为了确保流水线能产生 HTML 报告,可以在项目的 playwright.config.ts 中显式配置 reporter:
import { defineConfig } from '@playwright/test';
export default defineConfig({
reporter: [['html', { open: 'never' }]],
retries: process.env.CI ? 2 : 0,
workers: process.env.CI ? 1 : undefined,
});这段配置在 CI 中允许失败测试最多重试两次,并使用单 worker 获得更保守的执行稳定性。是否增加 worker 应根据 Runner 资源和测试隔离情况单独评估,而不是直接复制固定数值。
创建 GitHub Actions 工作流
在仓库中创建 .github/workflows/playwright.yml。下面的工作流会在 main 分支收到 push 或 pull request 时执行测试,并在结束后上传 playwright-report:
name: Playwright Tests
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 60
steps:
- name: Checkout repository
uses: actions/checkout@v6
- name: Setup Node.js
uses: actions/setup-node@v6
with:
node-version: lts/*
cache: npm
- name: Install dependencies
run: npm ci
- name: Install Playwright browsers
run: npx playwright install --with-deps
- name: Run Playwright tests
run: npx playwright test
- name: Upload Playwright report
if: ${{ !cancelled() }}
uses: actions/upload-artifact@v5
with:
name: playwright-report
path: playwright-report/
retention-days: 30这里使用 npm ci 而不是普通的 npm install,前提是仓库已经提交与 package.json 匹配的锁文件。npx playwright install --with-deps 同时准备浏览器和 Linux Runner 所需的系统依赖。
在本地验证 CI 的核心命令
提交工作流前,至少先确认项目自身能够通过同一条测试命令。这样可以把“测试本身失败”和“CI 配置错误”分开处理:
npx playwright test预期输出
Running <N> tests using <N> worker(s)
...
<N> passed (<TIME>)实际测试数量、worker 数量和耗时会随项目配置变化。命令成功时进程退出码应为 0;存在最终未通过的测试时,CI Job 会因非零退出码而失败。
保留失败证据并检查流水线
测试失败并不意味着报告上传步骤也应该跳过。工作流中的 if: ${{ !cancelled() }} 允许前面的测试步骤失败后继续上传报告,但在整个工作流被主动取消时不再执行该步骤。这样既保留测试 Job 的失败状态,也能获得排查材料。
首次接入后应检查三个结果:成功用例能够让 Job 通过;故意制造断言失败时 Job 会变红;失败运行仍能在该次流水线的 Artifacts 中看到 playwright-report。下载并解压报告后,可以在具有 Playwright 项目依赖的环境中查看:
npx playwright show-report <PATH>预期结果
Serving HTML report at http://localhost:<PORT><PATH> 是解压后的报告目录,<PORT> 由实际运行环境决定。浏览器打开对应地址后,应能查看测试状态和失败详情。
当本地命令、CI 退出状态和报告保存三者都符合预期后,这条流水线才算形成完整闭环:提交触发测试,失败能够阻止错误变更悄悄通过,同时留下足够的证据供后续定位。