跨平台开发 / 系统课时

清理依赖执行顺序的测试

清理依赖执行顺序的测试

只有按固定顺序运行才通过的测试,本质上把“前一个测试做过什么”当成了隐藏前置条件。本篇把这些前置条件移回各自用例,让任意测试都能单独运行、重复运行,也能在测试集调整后保持稳定。

学习目标

  • 识别由前序测试准备状态造成的顺序依赖
  • 用 setUp 和测试内准备步骤建立独立前置条件
  • 为文件、连接等外部资源建立对应的清理边界

顺序依赖通常长什么样

最典型的坏味道是:第一个测试负责“创建或登录”,第二个测试直接假设该状态已经存在。单独运行第二个测试时失败,但整文件按当前顺序运行时通过,于是问题长期被掩盖。

下面是片段示例,依赖上下文中已经定义的 SessionStore。它故意展示错误结构,不应作为最终测试保留。

dart
final store = SessionStore();

test('login saves token', () {
  store.login('token-a');
  expect(store.token, 'token-a');
});

test('logout clears token', () {
  store.logout();
  expect(store.token, isNull);
});

预期结果

text
第二个测试依赖第一个测试先执行 login;单独运行 logout 测试时,前置状态并未由它自己建立。

顺序依赖不仅来自内存对象,也可能来自数据库记录、临时文件、当前工作目录、环境变量或模拟服务器。判断标准很简单:一个测试需要的状态,是否能从这个测试自身和它的固定夹具中看出来。

让每个测试自己建立前置条件

重构时先把可变对象移到 late 变量,再在 setUp 中为每个测试创建新实例。对于某个用例特有的状态,例如“退出前必须已登录”,直接在该测试内部准备,不借用其他测试的副作用。

dart
import 'package:test/test.dart';

class SessionStore {
  String? token;

  void login(String value) {
    token = value;
  }

  void logout() {
    token = null;
  }
}

void main() {
  late SessionStore store;

  setUp(() {
    // 每个测试拿到独立实例,执行顺序不再携带业务状态。
    store = SessionStore();
  });

  test('login saves token', () {
    store.login('token-a');

    expect(store.token, 'token-a');
  });

  test('logout clears token', () {
    // 这个前置条件只服务当前测试,应由当前测试明确建立。
    store.login('token-b');
    store.logout();

    expect(store.token, isNull);
  });
}

预期输出

text
使用 dart test test/session_store_test.dart 执行时,2 个测试通过;任意一个测试单独运行也具备完整前置条件。

此时测试名称、准备动作和断言形成了闭合关系。即使以后交换两个 test 的声明位置,或只用 --name 运行其中一个,用例语义也不会改变。

外部资源也必须按测试隔离

如果测试会创建临时文件、打开连接或修改进程级设置,原则仍然相同:谁创建,谁负责恢复。可以在 setUp 中创建每例资源,在 tearDown 中释放;若资源只属于某个测试,则更适合在该测试中创建,并注册对应清理。

清理代码本身也要可等待。异步关闭连接、删除目录或停止服务时,应让测试框架等待清理完成,否则下一个测试可能在资源尚未释放时开始,形成看似“顺序相关”的竞争问题。

验收重构是否真正完成

重构后至少做三种检查:单独运行每个测试、运行整个文件、再连续运行整个文件多次。如果任一种方式出现不同结果,就继续寻找未隔离的状态。

一个可靠的单元测试应满足:前置条件显式、可变状态私有、清理责任清楚。做到这三点后,执行顺序就只是测试框架的调度细节,而不再是测试能否通过的隐藏条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

清理依赖执行顺序的测试

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

登录哪都通