自动化测试 / 系统课时

清理测试数据

清理测试数据

本课解决测试执行后用户、订单等临时数据残留,导致后续用例互相干扰的问题。通过 Playwright 的后置钩子删除本次创建的资源,并验证删除结果,让测试在正常通过或断言失败时都能尽可能恢复环境。

学习目标

  • 理解测试数据清理的必要性,区分常见清理策略。
  • 掌握使用 afterEach 清理测试资源的方法。
  • 学会验证清理结果,并处理异常与并发测试的边界。

为什么需要清理测试数据

自动化测试会不断创建用户、订单等业务数据。如果这些数据长期保留,数据库会积累无效记录,也可能导致唯一性校验、查询结果等测试异常。

例如,某个用户注册测试固定创建用户名 test_user。第一次执行成功后,如果没有删除该用户,第二次执行可能因为用户名重复而失败。这种失败与被测试的注册功能是否正确无关。

清理策略需要根据业务特点选择,例如删除临时数据、恢复测试状态,或者使用独立测试环境隔离数据。

清理时应遵循两个原则:只删除本次测试创建的数据,并且让删除操作的结果可以被检查。推荐为测试数据使用 temp_ 等明确前缀和唯一标识,避免与真实业务记录混淆。

使用 Playwright 后置逻辑清理

Playwright 提供 afterEach 和 afterAll 等生命周期钩子,可以在测试结束后执行清理操作。afterEach 在每个测试完成后执行,包括测试断言失败的情况;afterAll 则适合清理一组测试共同使用的资源。

一次创建用户测试可以分为三个阶段:创建临时资源、执行验证、删除资源。无论测试主体正常完成还是断言失败,执行流程都会进入 afterEach,前提是测试进程能够正常执行后置钩子。

Playwright 测试数据创建验证与后置清理的执行流程

下面示例通过 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 指定测试服务地址。

ts
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,然后执行:

bash
npx playwright test tests/cleanup.spec.ts --reporter=line

预期输出(测试服务可用且接口符合约定时):

text
1 passed (<TIME>)

其中 <TIME> 是实际测试耗时,每次运行可能不同。测试通过不仅意味着创建断言成功,也意味着清理钩子中的删除与查询验证全部通过。

还可以做一次失败路径验证:临时将创建用户测试中的 expect(userId).toBeTruthy() 改成 expect(userId).toBe('invalid-id'),再次运行测试。预期结果是测试因故意设置的断言失败而报告失败,但 afterEach 仍执行删除操作。可以通过测试服务的请求日志或数据查询确认临时用户已经删除。验证完毕后恢复原断言。

常见清理方案与异常边界

小规模测试通常直接删除测试数据;复杂系统可能使用数据回滚、数据库快照或专用测试租户。选择时可根据资源的创建范围和业务副作用判断。

  • 逐条删除:适用于通过 API 创建的用户、订单等独立资源。使用 afterEach 清理当前测试创建的记录。
  • 统一清理:适用于一组测试共同创建的共享资源。可以使用 afterAll,但不能依赖它替代每条测试的隔离。
  • 事务回滚:适用于可控制数据库事务的测试环境。如果业务操作涉及外部服务或独立事务,单个数据库回滚可能无法恢复全部副作用。
  • 独立测试环境或快照:适用于资源关联复杂、需要整体恢复状态的集成测试,恢复前应确认不会覆盖其他并发测试的数据。

清理逻辑也需要保证异常情况下仍能执行。例如测试断言失败时,后置清理仍应该运行,避免环境持续污染。但必须认识到以下边界:

  • 如果创建请求已经成功,而响应丢失或解析失败,测试可能无法获得 userId。可以为测试数据增加运行批次标识,并通过定期清理任务处理遗漏记录。
  • 如果删除接口因权限不足、网络异常或服务故障失败,应让清理步骤明确报错,并保留资源标识以便排查,不应静默忽略失败。
  • 如果测试进程被强制终止,afterEach 不保证执行。关键测试环境应额外设置临时数据过期清理机制。
  • 并发测试应按测试实例管理资源,不要使用共享变量记录不同测试的用户 ID,也不要通过删除所有 temp_ 用户来清理当前用例。

生产环境的数据不得作为清理目标。实际项目中,应使用独立测试账号、测试租户和限定权限的 API 凭证,让清理范围可以被准确识别和审计。

测试数据清理完成的判断标准是:本次创建的资源有明确标识、清理步骤得到执行、删除结果经过验证,并且清理失败能够被测试报告发现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

清理测试数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通