跨平台开发 / 系统课时
读懂测试失败输出与堆栈
读懂测试失败输出与堆栈
测试失败后,先分清“值不符合预期”还是“代码执行时抛异常”,再看堆栈中第一个属于自己项目的调用帧,通常比从头阅读整段日志更快。本文通过两个故意失败的测试,演示定位、修复和重新验证的完整路径。
学习目标
- 从
Expected、Actual和异常类型判断失败性质。 - 在堆栈中找到最有价值的项目代码调用帧。
- 修复失败后重新运行目标测试,确认问题真正消失。
先判断失败属于哪一类
常见失败可以先分成三类:测试文件无法加载、测试执行中抛出未处理异常、断言执行完成但实际值与预期值不同。前者优先看导入和编译错误;后两类才需要重点阅读断言差异与调用堆栈。
断言差异回答“结果错在哪里”,异常信息回答“执行为什么中断”,堆栈则回答“这次失败经过了哪些调用路径”。这三部分不要混在一起读。
制造两个可读的失败
下面的生产代码故意保留两个缺陷:重试序号 0 应对应 100ms 延迟,因此索引 3 应得到 400ms;非法重试次数应回退为 0,但当前实现会直接抛出 FormatException。片段示例:将它保存为 lib/retry/retry_policy.dart,由测试文件导入后执行。
int retryDelayMs(int retryIndex) {
return retryIndex * 100;
}
int parseRetryCount(String raw) {
return int.parse(raw);
}完整测试文件保存为 test/retry/retry_policy_test.dart,分别覆盖数值差异和意外异常。
import 'package:test/test.dart';
import '../../lib/retry/retry_policy.dart';
void main() {
group('RetryPolicy', () {
test('uses one-based retry delay', () {
expect(retryDelayMs(3), 400);
});
test('falls back to zero for invalid retry count', () {
expect(parseRetryCount('oops'), 0);
});
});
}运行扩展输出,便于看到每个测试的名称和错误上下文。
dart test test/retry/retry_policy_test.dart -r expanded预期结果(关键片段,<TIME>、<PATH> 和 <LINE> 的实际值可能不同)
<TIME> +0 -1: RetryPolicy uses one-based retry delay [E]
Expected: <400>
Actual: <300>
<TIME> +0 -2: RetryPolicy falls back to zero for invalid retry count [E]
FormatException: Invalid radix-10 number
<PATH>/lib/retry/retry_policy.dart:<LINE>
<PATH>/test/retry/retry_policy_test.dart:<LINE>
<TIME> +0 -2: Some tests failed.第一处失败已经完成函数调用,只是 expect 比较出的值不同;第二处在返回值产生前就被 int.parse 中断,因此异常类型和堆栈比 Expected/Actual 更重要。
从最有价值的调用帧开始读
读取断言差异时,先确认预期值是否真的代表需求,再看实际值是固定偏差、边界错误还是完全异常。这里 400 与 300 相差一个 100ms 步长,直接提示“索引从 0 还是从 1 计算”的边界问题。
读取异常堆栈时,从上往下跳过 package:test、package:matcher 等框架内部帧,优先找到第一个属于项目 lib 的帧。它通常是异常最接近业务代码的发生点;随后再找 test 目录中的帧,确认是哪一个测试输入触发了这条路径。
修复后必须重跑同一目标
根据测试表达的规则,修复两个函数:延迟按“重试序号 + 1”计算,解析失败时返回 0。片段示例:用下面内容替换 lib/retry/retry_policy.dart 中对应实现,再由原测试验证。
int retryDelayMs(int retryIndex) {
return (retryIndex + 1) * 100;
}
int parseRetryCount(String raw) {
return int.tryParse(raw) ?? 0;
}再次运行原来的测试命令:
dart test test/retry/retry_policy_test.dart -r expanded预期输出
00:00 +0: RetryPolicy uses one-based retry delay
00:00 +1: RetryPolicy falls back to zero for invalid retry count
00:00 +2: All tests passed!时间前缀可能不同,但两个原失败用例都应转为通过。排查测试失败时,最可靠的顺序是先识别失败类型,再锁定项目调用帧,最后用同一条测试命令验证修复,而不是只凭修改后的代码“看起来正确”就结束。