自动化测试 / 系统课时
清理测试数据
清理测试数据
本课解决测试执行后用户、订单等临时数据残留,导致后续用例互相干扰的问题。通过 Playwright 的后置钩子删除本次创建的资源,并验证删除结果,让测试在正常通过或断言失败时都能尽可能恢复环境。
学习目标
- 理解测试数据清理的必要性,区分常见清理策略。
- 掌握使用
afterEach清理测试资源的方法。 - 学会验证清理结果,并处理异常与并发测试的边界。
为什么需要清理测试数据
自动化测试会不断创建用户、订单等业务数据。如果这些数据长期保留,数据库会积累无效记录,也可能导致唯一性校验、查询结果等测试异常。
例如,某个用户注册测试固定创建用户名 test_user。第一次执行成功后,如果没有删除该用户,第二次执行可能因为用户名重复而失败。这种失败与被测试的注册功能是否正确无关。
清理策略需要根据业务特点选择,例如删除临时数据、恢复测试状态,或者使用独立测试环境隔离数据。
清理时应遵循两个原则:只删除本次测试创建的数据,并且让删除操作的结果可以被检查。推荐为测试数据使用 temp_ 等明确前缀和唯一标识,避免与真实业务记录混淆。
使用 Playwright 后置逻辑清理
Playwright 提供 afterEach 和 afterAll 等生命周期钩子,可以在测试结束后执行清理操作。afterEach 在每个测试完成后执行,包括测试断言失败的情况;afterAll 则适合清理一组测试共同使用的资源。
一次创建用户测试可以分为三个阶段:创建临时资源、执行验证、删除资源。无论测试主体正常完成还是断言失败,执行流程都会进入 afterEach,前提是测试进程能够正常执行后置钩子。

下面示例通过 API 创建用户,再在 afterEach 中删除该用户。示例假设已有可访问的测试服务,且提供以下接口约定:
POST /api/users:接收username,创建成功返回 HTTP 201 和包含字符串id的 JSON 对象。DELETE /api/users/{id}:删除指定用户,成功返回 HTTP 204。GET /api/users/{id}:用户不存在时返回 HTTP 404。
将代码保存为 tests/cleanup.spec.ts,并通过环境变量 TEST_API_BASE_URL 指定测试服务地址。
import { test, expect } from '@playwright/test';
import { randomUUID } from 'node:crypto';
const apiBaseURL = process.env.TEST_API_BASE_URL;
if (!apiBaseURL) {
throw new Error('请设置 TEST_API_BASE_URL');
}
test.describe('临时用户清理', () => {
let userId: string | undefined;
test.afterEach(async ({ request }) => {
// 创建未成功返回资源 ID 时,不执行未知目标的删除
if (!userId) return;
const url = `${apiBaseURL}/api/users/${encodeURIComponent(userId)}`;
const deleted = await request.delete(url);
expect(deleted.status()).toBe(204);
// 再次查询,确认资源确实已经不可访问
const lookup = await request.get(url);
expect(lookup.status()).toBe(404);
userId = undefined;
});
test('创建并验证用户', async ({ request }) => {
const response = await request.post(`${apiBaseURL}/api/users`, {
data: { username: `temp_${randomUUID()}` }
});
expect(response.status()).toBe(201);
const user = (await response.json()) as { id: string };
// 尽早保存资源 ID,供后置钩子定位本次创建的数据
userId = user.id;
expect(userId).toBeTruthy();
});
});预期结果:测试服务符合上述接口约定时,用户创建断言通过,随后 afterEach 删除该用户;删除请求返回 204,后续查询返回 404。如果删除失败或资源仍然存在,后置钩子中的断言会失败,不会将清理异常当作成功处理。
这里使用唯一用户名,避免不同运行之间发生用户名冲突。userId 仅服务于示例中的单个测试;如果同一个文件包含多个并发测试,不应直接共享这样的可变变量,应改用测试级 fixture 或其他按测试隔离的资源记录方式。
运行与验证清理结果
先启动测试 API 服务,并在终端中设置环境变量 TEST_API_BASE_URL,使其指向测试服务,例如 http://127.0.0.1:<PORT>,其中 <PORT> 需要替换为实际端口。确认项目已经安装 @playwright/test,然后执行:
npx playwright test tests/cleanup.spec.ts --reporter=line预期输出(测试服务可用且接口符合约定时):
1 passed (<TIME>)其中 <TIME> 是实际测试耗时,每次运行可能不同。测试通过不仅意味着创建断言成功,也意味着清理钩子中的删除与查询验证全部通过。
还可以做一次失败路径验证:临时将创建用户测试中的 expect(userId).toBeTruthy() 改成 expect(userId).toBe('invalid-id'),再次运行测试。预期结果是测试因故意设置的断言失败而报告失败,但 afterEach 仍执行删除操作。可以通过测试服务的请求日志或数据查询确认临时用户已经删除。验证完毕后恢复原断言。
常见清理方案与异常边界
小规模测试通常直接删除测试数据;复杂系统可能使用数据回滚、数据库快照或专用测试租户。选择时可根据资源的创建范围和业务副作用判断。
- 逐条删除:适用于通过 API 创建的用户、订单等独立资源。使用
afterEach清理当前测试创建的记录。 - 统一清理:适用于一组测试共同创建的共享资源。可以使用
afterAll,但不能依赖它替代每条测试的隔离。 - 事务回滚:适用于可控制数据库事务的测试环境。如果业务操作涉及外部服务或独立事务,单个数据库回滚可能无法恢复全部副作用。
- 独立测试环境或快照:适用于资源关联复杂、需要整体恢复状态的集成测试,恢复前应确认不会覆盖其他并发测试的数据。
清理逻辑也需要保证异常情况下仍能执行。例如测试断言失败时,后置清理仍应该运行,避免环境持续污染。但必须认识到以下边界:
- 如果创建请求已经成功,而响应丢失或解析失败,测试可能无法获得
userId。可以为测试数据增加运行批次标识,并通过定期清理任务处理遗漏记录。 - 如果删除接口因权限不足、网络异常或服务故障失败,应让清理步骤明确报错,并保留资源标识以便排查,不应静默忽略失败。
- 如果测试进程被强制终止,
afterEach不保证执行。关键测试环境应额外设置临时数据过期清理机制。 - 并发测试应按测试实例管理资源,不要使用共享变量记录不同测试的用户 ID,也不要通过删除所有
temp_用户来清理当前用例。
生产环境的数据不得作为清理目标。实际项目中,应使用独立测试账号、测试租户和限定权限的 API 凭证,让清理范围可以被准确识别和审计。
测试数据清理完成的判断标准是:本次创建的资源有明确标识、清理步骤得到执行、删除结果经过验证,并且清理失败能够被测试报告发现。