自动化测试 / 系统课时
接入测试框架
接入测试框架
把 Selenium 脚本接入 pytest 后,可以统一完成用例发现、浏览器初始化、失败报告和资源清理。最终目标是让测试只负责操作与断言,而浏览器生命周期交给 fixture 管理,并能用一条命令稳定执行整套 UI 用例。
学习目标
- 使用 pytest fixture 管理 WebDriver 的创建与关闭
- 用 pytest 发现并执行 Selenium 测试,同时获得明确的通过或失败结果
- 配置统一的测试目录、输出格式和异常回溯方式
安装并验证测试依赖
以下做法适用于 Python 3.10+、pytest 8.x 及 Selenium 4.x。Selenium 4.6 及以后通常可由 Selenium Manager 自动处理兼容的浏览器驱动,但本机仍需要安装对应浏览器,例如 Chrome。
先在项目虚拟环境中安装 pytest 与 Selenium:
python -m pip install pytest selenium预期结果
Successfully installed <PACKAGE_LIST>如果依赖已经存在,pip 可能显示 Requirement already satisfied,这同样表示安装步骤成功。继续执行版本检查,确认当前 Python 环境确实能导入两个包:
python -c "import pytest, selenium; print(pytest.__version__, selenium.__version__)"预期输出
<PYTEST_VERSION> <SELENIUM_VERSION>版本号会随本机环境变化;若出现 ModuleNotFoundError,优先检查安装依赖和运行 pytest 是否使用了同一个 Python 解释器。
用 fixture 管理浏览器生命周期
pytest fixture 很适合承接 WebDriver 的初始化与销毁。下面的 driver fixture 在每个测试开始前创建无头 Chrome,在测试完成后无论断言是否失败都会执行 quit(),避免遗留浏览器进程。
import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By
@pytest.fixture
def driver():
options = webdriver.ChromeOptions()
options.add_argument("--headless=new")
browser = webdriver.Chrome(options=options)
browser.set_page_load_timeout(10)
yield browser
browser.quit()
def test_page_status(driver):
driver.get(
"data:text/html,<title>Smoke Test</title>"
"<h1 id='status'>Ready</h1>"
)
assert driver.title == "Smoke Test"
assert driver.find_element(By.ID, "status").text == "Ready"将文件保存为 tests/test_smoke.py 后执行:
python -m pytest tests/test_smoke.py -q预期输出
. [100%]
1 passed in <TIME>s<TIME> 是动态值。把 browser.quit() 写在普通测试函数结尾是常见错误:一旦前面的定位或断言抛异常,关闭语句可能根本不会执行;放在 yield fixture 的清理阶段更可靠。

固定 pytest 的运行约定
多人项目不要让每个人记一套命令参数。可在项目根目录创建 pytest.ini,统一指定测试目录、简洁输出和短异常回溯,并提前登记 UI 测试常用 marker。
[pytest]
testpaths = tests
addopts = -q --tb=short
markers =
smoke: critical UI smoke tests
regression: full regression tests这是配置文件,不产生独立控制台输出。保存后在项目根目录执行 python -m pytest 即会自动读取配置;验证方法是故意加入一个失败断言,确认报告使用短回溯,而不是完整 Python 调用栈。
用退出码判断自动化结果
pytest 不只给人阅读结果,也通过进程退出码告诉 CI 是否成功。正常全部通过时退出码为 0,存在测试失败时通常为 1,没有收集到测试时为 5;因此流水线无需解析屏幕上的 passed 文本。
可以直接运行测试并让 shell 接收 pytest 的退出状态:
python -m pytest预期输出
. [100%]
1 passed in <TIME>s实际项目接入 GitHub Actions、GitLab CI 或 Jenkins 时,应让测试命令的退出码原样传递给流水线,不要在命令后追加无条件成功的处理。这样断言失败、fixture 初始化失败或浏览器启动异常都会直接阻止测试阶段被误判为成功。