自动化测试 / 系统课时
接入持续集成流程
接入持续集成流程
持续集成要解决的不是“在服务器上再跑一次 Selenium”,而是让每次提交都按同一环境安装依赖、启动浏览器、执行测试并留下可追踪的结果。本篇以 GitHub Actions、Python、pytest 和 Chrome 为例,把一条可直接落地的流水线跑通。
学习目标
- 将 Selenium 测试整理成 CI 可重复执行的命令,并生成 JUnit XML 报告。
- 配置 GitHub Actions,在提交和拉取请求时自动安装依赖并运行测试。
- 设置失败门禁、超时与报告归档,使失败提交能够被定位而不是只得到一个红叉。
先把测试变成可重复命令
CI 最怕依赖本机状态。测试应自行创建 WebDriver、使用无界面模式并在结束时调用 quit()。下面的冒烟测试不访问公网,而是加载 data: 页面,因此适合先验证浏览器和 Selenium 环境是否正常。
from selenium import webdriver
from selenium.webdriver.common.by import By
def test_ci_smoke():
options = webdriver.ChromeOptions()
options.add_argument("--headless=new")
driver = webdriver.Chrome(options=options)
try:
driver.get(
"data:text/html,%3Ctitle%3ECI%20Smoke%3C/title%3E"
"%3Ch1%20id%3D%22status%22%3Eready%3C/h1%3E"
)
assert driver.title == "CI Smoke"
assert driver.find_element(By.ID, "status").text == "ready"
finally:
driver.quit()在仓库根目录执行测试,并同时生成机器可读取的 JUnit XML。artifacts 目录必须先创建,避免报告目标目录不存在。
mkdir -p artifacts
python -m pytest tests -q --junitxml=artifacts/junit.xml预期输出:测试通过时 pytest 返回退出码 0,耗时会随运行环境变化。
. [100%]
1 passed in <TIME>s配置 GitHub Actions 工作流
在仓库创建 .github/workflows/selenium.yml。下面配置针对 Python 3.12,在 main 分支的提交和拉取请求上执行,并保留测试报告;timeout-minutes: 15 可以阻止浏览器挂死后无限占用 Runner。
name: selenium-ci
on:
push:
branches: [main]
pull_request:
branches: [main]
workflow_dispatch:
jobs:
selenium:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.12"
cache: pip
- name: Set up Chrome
uses: browser-actions/setup-chrome@v1
with:
chrome-version: stable
- name: Install dependencies
run: |
python -m pip install --upgrade pip
python -m pip install selenium pytest
- name: Run Selenium tests
run: |
mkdir -p artifacts
python -m pytest tests -q --junitxml=artifacts/junit.xml
- name: Upload test report
if: always()
uses: actions/upload-artifact@v4
with:
name: selenium-junit-${{ github.run_id }}
path: artifacts/junit.xml
if-no-files-found: warn
retention-days: 14该配置生效后,推送到 main 或创建指向 main 的 Pull Request 都会创建 selenium job。验证时应同时检查测试步骤状态和 Artifacts 区域:成功或失败运行都应尝试上传 junit.xml,因为上传步骤使用了 if: always()。

设置触发范围与失败门禁
并不是所有提交都值得跑完整浏览器套件。常见做法是 Pull Request 跑冒烟与核心回归,合并到 main 后再跑完整集合。pytest 可以用 marker 把两类测试分开,例如给核心用例标记 smoke,流水线运行 python -m pytest -m smoke。
如果团队频繁向同一分支推送,可以增加并发控制,让旧运行自动取消,避免 5 次连续提交排队跑 5 份已经过期的浏览器测试。下面是工作流顶层的片段示例,依赖前面的 GitHub Actions 工作流上下文。
concurrency:
group: selenium-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true生效后,同一工作流和同一 Git ref 的旧运行会在新运行开始时取消。对于要求合并前 Selenium 必须通过的仓库,还应在分支保护规则中把 selenium job 对应的检查设为必需状态检查;这样测试失败时 Pull Request 不能按正常流程合并。
验收一条可用的 CI 流程
首次接入时不要只看 Actions 页面是否出现绿色图标,应实际做一次成功和一次失败验证。成功测试应得到退出码 0 与 JUnit 报告;随后临时把断言改成错误值,例如把 "CI Smoke" 改成 "Wrong Title",确认 pytest 返回非零退出码、job 标记失败,同时报告仍被上传。
验收至少检查以下三点:正常提交能自动触发;断言失败能够阻止测试步骤通过;无论测试成功还是失败,selenium-junit-<RUN_ID> 中都有 junit.xml。完成失败验证后立即恢复正确断言,避免把故意失败的测试提交到主分支。