跨平台开发 / 系统课时
定位偶发失败与共享状态
定位偶发失败与共享状态
偶发失败最难之处不是断言本身,而是失败条件藏在执行次数、随机输入或其他测试留下的状态里。本篇用可复现种子和每例隔离的状态,把“偶尔红一次”转成可以稳定定位和验证的问题。
学习目标
- 用重复执行与单例筛选缩小偶发失败范围
- 识别随机数据、全局变量和单例缓存造成的测试耦合
- 用
setUp重建状态,并保留随机种子以便复现
先判断失败是否来自测试外部
如果一个测试单独运行稳定、整套运行却偶尔失败,优先怀疑它读取或修改了测试之外的可变状态。常见对象包括顶层变量、静态字段、单例缓存、临时文件、环境变量,以及由多个测试共同消费的随机数生成器。
| 现象 | 优先检查 |
|---|---|
| 单独运行通过,整套运行失败 | 全局变量、单例、共享文件或缓存 |
| 每次失败输入不同 | 未固定的随机数据或时间 |
| 重跑若干次才出现一次 | 竞争条件、异步清理或状态泄漏 |
先用 dart test test/<FILE>.dart --name "<TEST_NAME>" 缩到单个用例,再扩大到整个文件。若单例稳定而文件级不稳定,说明测试之间的边界比业务代码本身更值得检查。
把随机性和共享状态都变成可控输入
不要让诊断过程继续依赖新的随机结果。下面的完整测试文件从环境变量读取种子;同时,虽然 cache 在两个测试间共享变量名,但 setUp 会在每个测试前创建新列表,因此前一个测试写入的数据不会泄漏到后一个测试。
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);
});
}预期结果
使用同一个 TEST_SEED 重跑时,随机样本可复现;两个测试都从独立的空 cache 开始并通过。这里的关键不是“禁止随机测试”,而是让随机性可以回放。若失败时记录了种子,就能用同一个 TEST_SEED 重现输入,而不是等待下一次碰巧失败。
用重复执行确认问题是否消失
修复一次通过还不够。对原本偶发失败的文件连续执行多次,可以验证隔离是否真正生效。以下 Bash 命令固定种子并连续运行 20 次,遇到第一次失败就停止。
for i in {1..20}; do TEST_SEED=20260916 dart test test/shared_state_test.dart || break; done预期输出
20 次运行均通过;若仍存在共享状态或异步清理问题,循环会在第一次失败时停止。实际测试耗时和进度行会因机器与测试数量不同而变化。若固定种子后仍然不稳定,应继续检查未等待完成的异步任务、共享文件路径以及进程级单例,而不是不断扩大重试次数。
修复共享状态时避免两个误区
setUpAll 只在一组测试开始前执行一次,适合创建昂贵且只读的夹具,不适合承载会被测试修改的对象。需要每例干净状态时,应优先使用 setUp;需要释放资源时,再用 tearDown 或对应的清理逻辑。
另一个误区是只给失败测试加重试。重试可以缓解短期噪声,却会隐藏状态泄漏。可靠的标准应是:同一输入可复现、每个测试拥有自己的可变状态,并且重复运行后结果仍一致。