跨平台开发 / 系统课时

定位偶发失败与共享状态

定位偶发失败与共享状态

偶发失败最难之处不是断言本身,而是失败条件藏在执行次数、随机输入或其他测试留下的状态里。本篇用可复现种子和每例隔离的状态,把“偶尔红一次”转成可以稳定定位和验证的问题。

学习目标

  • 用重复执行与单例筛选缩小偶发失败范围
  • 识别随机数据、全局变量和单例缓存造成的测试耦合
  • 用 setUp 重建状态,并保留随机种子以便复现

先判断失败是否来自测试外部

如果一个测试单独运行稳定、整套运行却偶尔失败,优先怀疑它读取或修改了测试之外的可变状态。常见对象包括顶层变量、静态字段、单例缓存、临时文件、环境变量,以及由多个测试共同消费的随机数生成器。

现象 优先检查
单独运行通过,整套运行失败 全局变量、单例、共享文件或缓存
每次失败输入不同 未固定的随机数据或时间
重跑若干次才出现一次 竞争条件、异步清理或状态泄漏

先用 dart test test/<FILE>.dart --name "<TEST_NAME>" 缩到单个用例,再扩大到整个文件。若单例稳定而文件级不稳定,说明测试之间的边界比业务代码本身更值得检查。

把随机性和共享状态都变成可控输入

不要让诊断过程继续依赖新的随机结果。下面的完整测试文件从环境变量读取种子;同时,虽然 cache 在两个测试间共享变量名,但 setUp 会在每个测试前创建新列表,因此前一个测试写入的数据不会泄漏到后一个测试。

dart
import 'dart:io';
import 'dart:math';

import 'package:test/test.dart';

int testSeed() {
  return int.tryParse(Platform.environment['TEST_SEED'] ?? '') ?? 20260916;
}

void main() {
  late List<int> cache;

  setUp(() {
    // 每个测试都拿到新的列表,避免前一个测试留下数据。
    cache = <int>[];
  });

  test('random sample is reproducible', () {
    final random = Random(testSeed());
    cache.add(random.nextInt(100));

    expect(cache, hasLength(1));
    expect(cache.single, inInclusiveRange(0, 99));
  });

  test('cache starts empty', () {
    expect(cache, isEmpty);
  });
}

预期结果

text
使用同一个 TEST_SEED 重跑时,随机样本可复现;两个测试都从独立的空 cache 开始并通过。

这里的关键不是“禁止随机测试”,而是让随机性可以回放。若失败时记录了种子,就能用同一个 TEST_SEED 重现输入,而不是等待下一次碰巧失败。

用重复执行确认问题是否消失

修复一次通过还不够。对原本偶发失败的文件连续执行多次,可以验证隔离是否真正生效。以下 Bash 命令固定种子并连续运行 20 次,遇到第一次失败就停止。

bash
for i in {1..20}; do TEST_SEED=20260916 dart test test/shared_state_test.dart || break; done

预期输出

text
20 次运行均通过;若仍存在共享状态或异步清理问题,循环会在第一次失败时停止。

实际测试耗时和进度行会因机器与测试数量不同而变化。若固定种子后仍然不稳定,应继续检查未等待完成的异步任务、共享文件路径以及进程级单例,而不是不断扩大重试次数。

修复共享状态时避免两个误区

setUpAll 只在一组测试开始前执行一次,适合创建昂贵且只读的夹具,不适合承载会被测试修改的对象。需要每例干净状态时,应优先使用 setUp;需要释放资源时,再用 tearDown 或对应的清理逻辑。

另一个误区是只给失败测试加重试。重试可以缓解短期噪声,却会隐藏状态泄漏。可靠的标准应是:同一输入可复现、每个测试拥有自己的可变状态,并且重复运行后结果仍一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

定位偶发失败与共享状态

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

登录哪都通