自动化测试 / 系统课时
搭建可维护测试架构
搭建可维护测试架构
当用例从几个文件增长到几十个时,真正拖慢维护的通常不是断言,而是登录逻辑、定位器、环境地址和测试数据散落在各处。本节把 Fixture、页面对象、配置和数据模块组合成一套职责清晰、可扩展的 Playwright 测试架构。
学习目标
- 划分测试、Fixture、页面对象、配置和测试数据的职责边界
- 使用
test.extend()把页面对象注入测试,减少重复初始化代码 - 建立能随页面和场景增长而保持稳定的项目组织方式
先划清职责边界
可维护架构的核心不是“文件越多越专业”,而是变化发生时只改最相关的一层。测试文件描述业务意图和断言;页面对象封装定位器与页面操作;Fixture 负责对象创建和生命周期;配置集中环境级参数;数据模块只保存或生成测试输入。

这样分层后,按钮改名主要影响页面对象,测试环境切换主要影响配置,测试账号变化主要影响数据或专用 Fixture。测试本身应尽量保留“登录后看到仪表盘”这样的业务语义,而不是塞满定位器和初始化细节。
搭出最小可维护骨架
下面示例假设被测应用提供 /login,表单标签为 Email 和 Password,登录成功后出现 Dashboard 标题。账号需要事先存在于测试环境;示例中的 .test 域名和密码只用于演示,不应替换生产凭据。
playwright.config.ts 只保存跨测试共享的运行参数,不写具体页面选择器或业务数据。
import { defineConfig } from '@playwright/test';
export default defineConfig({
testDir: './tests',
use: {
// 环境地址允许由 CI 覆盖,本地保留稳定默认值。
baseURL: process.env.APP_BASE_URL ?? 'http://127.0.0.1:3000',
trace: 'on-first-retry',
},
});生效行为:page.goto('/login') 会基于 baseURL 解析完整地址;CI 可通过 APP_BASE_URL 切换目标环境。可用后文的测试命令验证配置是否正常加载。
tests/data/users.ts 是项目文件示例,不独立运行。它只描述测试输入,不负责登录动作。
export const users = {
// 真实项目应使用测试环境专用账号,避免提交生产秘密。
admin: {
email: 'admin@example.test',
password: 'P@ssw0rd!',
},
} as const;生效行为:测试通过 users.admin 获取稳定输入;更换账号或增加角色时,不需要修改页面对象中的操作逻辑。
tests/pages/login.page.ts 把定位器和页面动作收在同一处,让选择器变化不会扩散到所有测试。
import type { Locator, Page } from '@playwright/test';
type Credentials = {
email: string;
password: string;
};
export class LoginPage {
private readonly emailInput: Locator;
private readonly passwordInput: Locator;
constructor(private readonly page: Page) {
// 定位策略留在页面对象内部,测试只调用业务动作。
this.emailInput = page.getByLabel('Email');
this.passwordInput = page.getByLabel('Password');
}
async goto(): Promise<void> {
await this.page.goto('/login');
}
async login(user: Credentials): Promise<void> {
await this.emailInput.fill(user.email);
await this.passwordInput.fill(user.password);
await this.page.getByRole('button', { name: 'Sign in' }).click();
}
}生效行为:测试只需要调用 goto() 和 login();如果表单定位方式变化,只需调整这个页面对象。
tests/fixtures/app.fixture.ts 用 test.extend() 注入页面对象。Fixture 管理依赖创建,不需要手工关闭内置 page,Playwright 会在测试结束后处理它的生命周期。
import { test as base, expect } from '@playwright/test';
import { LoginPage } from '../pages/login.page';
type AppFixtures = {
loginPage: LoginPage;
};
export const test = base.extend<AppFixtures>({
// 只有声明了 loginPage 的测试才会准备这个 Fixture。
loginPage: async ({ page }, use) => {
await use(new LoginPage(page));
},
});
export { expect };生效行为:测试函数声明 loginPage 后,Playwright 自动创建并注入实例;未使用该 Fixture 的测试不会执行这段初始化。
最后,tests/login.spec.ts 只组合业务步骤、测试数据和结果断言。
import { test, expect } from './fixtures/app.fixture';
import { users } from './data/users';
test('管理员可以登录', async ({ loginPage, page }) => {
await loginPage.goto();
await loginPage.login(users.admin);
// 核心业务结果保留在测试中,阅读时能直接看到验收条件。
await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
});预期结果:在满足前述页面契约且测试账号有效时,Fixture 会为该用例创建 LoginPage,页面对象完成登录,最终由测试断言仪表盘标题可见。
运行这条用例:
npx playwright test tests/login.spec.ts预期输出:
Running 1 test using 1 worker
✓ 管理员可以登录
1 passed (<TIME>)实际耗时和报告中的文件行号可能不同,因此用 <TIME> 表示动态值。
让扩展点保持单一职责
新增“订单页”时,优先增加 OrderPage,再按需由 Fixture 注入;不要继续把订单定位器塞进 LoginPage。如果数据需要动态创建,可以把用户构造器或订单工厂放到数据模块;如果创建过程需要网络资源,再升级为独立 Fixture。
Fixture 也不应变成万能 beforeEach。只有用例声明所需 Fixture 时才准备依赖,可以减少无关初始化。昂贵资源若确实能安全共享,再评估 worker 级 Fixture;会被测试修改的浏览器状态和业务数据通常仍应保持测试隔离。
避开失控架构
常见失控信号包括:测试文件直接出现大量 CSS/XPath、页面对象读取环境变量、配置文件保存业务账号、Fixture 自动执行所有登录和建数步骤。它们都会让依赖方向反转,使一次小改动影响多个层次。
判断是否分层合理,可以用一个简单标准:一个变化是否能在最接近它的模块中被吸收。页面结构变了主要改 Page Object,环境变了主要改配置,输入变了主要改数据,业务预期变了主要改测试;满足这个条件,架构才是在降低维护成本,而不是单纯增加文件。