自动化测试 / 系统课时

准备测试数据

准备测试数据

稳定的端到端测试不应依赖“数据库里刚好存在一条可用记录”。本课使用 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 数据。

ts
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();
  }
});

预期输出

text
created order = <ID> e2e-p<VALUE>-<ID>

<ID> 和 <VALUE> 是动态值,实际运行时会分别替换为服务端生成的记录 ID、worker 索引和 UUID。只要创建、读取与删除请求均成功,用例即可稳定重复执行。

让数据准备适配并行与重试

唯一名称只是第一层隔离。并行测试如果共用同一账号、购物车、组织或余额,仍可能互相影响,因此需要从真正会被修改的业务边界进行隔离。必要时按 worker 分配独立账号,或让每个测试创建自己的父级资源。

重试也要考虑数据生命周期。若第一次运行失败但清理成功,重试可以重新创建新数据;若清理本身失败,下一次运行仍不应依赖旧记录。测试代码应始终以“创建本次需要的数据”为入口,而不是先搜索并复用名称相似的历史数据。

把清理当成测试设计的一部分

try...finally 能覆盖大多数断言失败场景,但进程被强制终止时清理仍可能来不及执行。测试环境最好再配一层兜底策略,例如给测试数据增加明确前缀、创建时间或专用租户,并由定时任务删除过期数据。

测试数据的核心标准不是“越接近生产越好”,而是可创建、可识别、相互隔离、可清理。当 UI 用例只负责验证用户路径,而数据准备通过稳定接口完成时,失败通常更容易复现,也更容易判断究竟是前置数据、后端接口还是页面交互出了问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备测试数据

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

登录哪都通