自动化测试 / 系统课时
准备测试数据
准备测试数据
稳定的端到端测试不应依赖“数据库里刚好存在一条可用记录”。本课使用 Playwright 的 API 请求能力在测试开始时创建专属业务数据,用唯一标识避免并行冲突,并在结束时清理,从而让用例可重复运行、可定位失败来源。
学习目标
- 在 UI 操作前通过 API 创建测试所需的业务数据。
- 为并行测试生成独立且可追踪的数据标识。
- 使用
try...finally保证成功或失败后都执行清理。
先定义可控的数据契约
准备测试数据最稳妥的入口通常是业务 API 或专门的测试支持 API,而不是通过 UI 连续点击创建。API 建数速度更快,也能把“准备数据失败”和“页面交互失败”分开定位。
下面示例约定测试环境提供 POST /api/test/orders、GET /api/test/orders/:id 和 DELETE /api/test/orders/:id。如果项目没有测试专用接口,应替换为真实业务 API,并保持创建、读取、清理三个动作具有明确权限和隔离边界。
创建独立且可识别的数据
示例把 Playwright 的 parallelIndex 与随机 UUID 组合成标记。并行 worker 不会因为固定名称争抢同一条记录,而失败日志又能直接看出这是一条 E2E 数据。
import { randomUUID } from 'node:crypto';
import { test, expect } from '@playwright/test';
const API_BASE_URL =
process.env.API_BASE_URL ?? 'http://127.0.0.1:3000';
test('uses an isolated order', async ({ request }, testInfo) => {
const marker = `e2e-p${testInfo.parallelIndex}-${randomUUID()}`;
const createResponse = await request.post(
`${API_BASE_URL}/api/test/orders`,
{
data: {
name: marker,
amount: 199,
status: 'draft',
},
},
);
expect(createResponse.ok()).toBeTruthy();
const order = (await createResponse.json()) as {
id: string;
name: string;
};
console.log(`created order = ${order.id} ${order.name}`);
try {
// 重新读取一次,确认后端已经持久化本测试的数据。
const getResponse = await request.get(
`${API_BASE_URL}/api/test/orders/${order.id}`,
);
expect(getResponse.ok()).toBeTruthy();
const loadedOrder = (await getResponse.json()) as {
id: string;
name: string;
};
expect(loadedOrder).toMatchObject({
id: order.id,
name: marker,
});
} finally {
// 即使用例中途断言失败,也尽量删除本次创建的数据。
const deleteResponse = await request.delete(
`${API_BASE_URL}/api/test/orders/${order.id}`,
);
expect(deleteResponse.ok()).toBeTruthy();
}
});预期输出
created order = <ID> e2e-p<VALUE>-<ID><ID> 和 <VALUE> 是动态值,实际运行时会分别替换为服务端生成的记录 ID、worker 索引和 UUID。只要创建、读取与删除请求均成功,用例即可稳定重复执行。
让数据准备适配并行与重试
唯一名称只是第一层隔离。并行测试如果共用同一账号、购物车、组织或余额,仍可能互相影响,因此需要从真正会被修改的业务边界进行隔离。必要时按 worker 分配独立账号,或让每个测试创建自己的父级资源。
重试也要考虑数据生命周期。若第一次运行失败但清理成功,重试可以重新创建新数据;若清理本身失败,下一次运行仍不应依赖旧记录。测试代码应始终以“创建本次需要的数据”为入口,而不是先搜索并复用名称相似的历史数据。
把清理当成测试设计的一部分
try...finally 能覆盖大多数断言失败场景,但进程被强制终止时清理仍可能来不及执行。测试环境最好再配一层兜底策略,例如给测试数据增加明确前缀、创建时间或专用租户,并由定时任务删除过期数据。
测试数据的核心标准不是“越接近生产越好”,而是可创建、可识别、相互隔离、可清理。当 UI 用例只负责验证用户路径,而数据准备通过稳定接口完成时,失败通常更容易复现,也更容易判断究竟是前置数据、后端接口还是页面交互出了问题。