自动化测试 / 系统课时
搭建可维护测试架构
搭建可维护测试架构
当 Selenium 用例从几条增长到几十条后,定位器、浏览器生命周期、环境地址和测试数据如果混在同一文件里,任何页面改动都会造成连锁修改。本篇搭出一个可直接运行的最小工程,把这些变化拆到 Page Object、fixture、配置和数据模块中。
学习目标
- 按职责拆分
pages、tests、配置与数据模块,保持依赖方向清晰。 - 用 pytest fixture 统一创建和销毁 WebDriver,会话之间不共享状态。
- 运行一个参数化用例,验证页面对象、配置和数据能够协同工作。
用四层职责切开变化
一个实用的边界是:测试文件只描述业务场景和断言,Page Object 只封装定位器与页面操作,fixture 管理浏览器资源,配置与数据模块提供可替换输入。这样页面改 ID 时主要改 pages,测试环境地址变化时只改配置。
| 路径 | 只负责什么 | 不应该放什么 |
|---|---|---|
config.py |
环境地址、等待时间等运行参数 | 页面定位器 |
data/cases.py |
参数化输入和期望值 | WebDriver 调用 |
pages/dynamic_page.py |
定位器、页面动作、页面级等待 | 业务断言 |
tests/conftest.py |
fixture、浏览器创建与回收 | 业务场景 |
tests/test_dynamic.py |
场景编排与断言 | 重复定位细节 |

这个结构不要求“每个页面一个巨型类”。页面里的稳定公共组件可以再拆成组件对象,但测试仍应通过清晰的业务方法调用它们,而不是回到测试文件里直接散写 CSS 或 XPath。
建立配置与数据入口
下面文件共同组成一个可运行项目;单个文件属于片段示例,需按给定路径一起保存。前提是本机已有 Python 3.11+ 与 Chrome。先用 requirements.txt 固定主版本范围,避免团队成员各自安装完全不同的依赖。
requirements.txt:
selenium>=4.25,<5
pytest>=8,<10安装并验证依赖:
python -m pip install -r requirements.txt
python -c "import selenium, pytest; print('deps-ok')"预期输出:
<PIP_OUTPUT>
deps-ok<PIP_OUTPUT> 代表 pip 根据当前环境产生的安装日志,只要最后打印 deps-ok 且命令退出码为 0 即通过。
config.py:
from dataclasses import dataclass
import os
@dataclass(frozen=True)
class Settings:
base_url: str
wait_seconds: float
@classmethod
def from_env(cls) -> "Settings":
return cls(
base_url=os.getenv(
"E2E_BASE_URL",
"https://www.selenium.dev/selenium/web/dynamic.html",
),
wait_seconds=float(os.getenv("E2E_WAIT_SECONDS", "5")),
)data/cases.py:
BOX_CASES = [
{"box_index": 0, "expected_class": "redbox"},
]这里把默认地址和等待上限集中到 Settings。CI 中可通过环境变量覆盖地址,例如把 E2E_BASE_URL 指向测试环境,而无需修改测试代码;数据模块则只保存输入和期望值,不持有浏览器对象。
把页面行为封装进 Page Object
pages/dynamic_page.py 把“点击添加按钮并等待目标方块出现”包装成页面行为。定位器集中保存,调用方不需要知道页面使用哪个 ID。
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait
class DynamicPage:
ADD_BUTTON = (By.ID, "adder")
def __init__(self, driver, wait_seconds: float):
self.driver = driver
self.wait = WebDriverWait(driver, wait_seconds)
def open(self, url: str) -> "DynamicPage":
self.driver.get(url)
return self
def add_box(self, index: int):
self.wait.until(EC.element_to_be_clickable(self.ADD_BUTTON)).click()
locator = (By.ID, f"box{index}")
return self.wait.until(EC.presence_of_element_located(locator))这个对象返回已经满足页面条件的 WebElement,但不在类里写 assert。业务是否正确由测试决定,这能避免页面对象同时承担“操作页面”和“判定测试成败”两种职责。
用 fixture 驱动用例并验收
tests/conftest.py 统一创建浏览器。fixture 使用 yield,测试结束后无论断言成功还是失败,都执行 quit() 回收整个会话。
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from config import Settings
@pytest.fixture(scope="session")
def settings():
return Settings.from_env()
@pytest.fixture
def driver():
options = Options()
options.add_argument("--headless=new")
browser = webdriver.Chrome(options=options)
yield browser
browser.quit()tests/test_dynamic.py 只保留场景编排和业务断言,测试数据通过 pytest.mark.parametrize 注入。
import pytest
from data.cases import BOX_CASES
from pages.dynamic_page import DynamicPage
@pytest.mark.parametrize("case", BOX_CASES)
def test_add_box(driver, settings, case):
page = DynamicPage(driver, settings.wait_seconds)
box = page.open(settings.base_url).add_box(case["box_index"])
actual_class = box.get_dom_attribute("class")
print(f"box{case['box_index']} class={actual_class}")
assert actual_class == case["expected_class"]从项目根目录执行:
python -m pytest -q -s预期输出:
box0 class=redbox
.
1 passed in <TIME>s<TIME> 会随机器和网络变化。验收时还应确认测试结束后没有遗留 Chrome 进程;如果把 driver 改成 session 级共享 fixture,虽然启动更快,却会让 Cookie、窗口和页面状态跨用例泄漏,通常不适合作为默认方案。