跨平台开发 / 系统课时

读懂测试失败输出与堆栈

读懂测试失败输出与堆栈

测试失败后,先分清“值不符合预期”还是“代码执行时抛异常”,再看堆栈中第一个属于自己项目的调用帧,通常比从头阅读整段日志更快。本文通过两个故意失败的测试,演示定位、修复和重新验证的完整路径。

学习目标

  • 从 Expected、Actual 和异常类型判断失败性质。
  • 在堆栈中找到最有价值的项目代码调用帧。
  • 修复失败后重新运行目标测试,确认问题真正消失。

先判断失败属于哪一类

常见失败可以先分成三类:测试文件无法加载、测试执行中抛出未处理异常、断言执行完成但实际值与预期值不同。前者优先看导入和编译错误;后两类才需要重点阅读断言差异与调用堆栈。

断言差异回答“结果错在哪里”,异常信息回答“执行为什么中断”,堆栈则回答“这次失败经过了哪些调用路径”。这三部分不要混在一起读。

制造两个可读的失败

下面的生产代码故意保留两个缺陷:重试序号 0 应对应 100ms 延迟,因此索引 3 应得到 400ms;非法重试次数应回退为 0,但当前实现会直接抛出 FormatException。片段示例:将它保存为 lib/retry/retry_policy.dart,由测试文件导入后执行。

dart
int retryDelayMs(int retryIndex) {
  return retryIndex * 100;
}

int parseRetryCount(String raw) {
  return int.parse(raw);
}

完整测试文件保存为 test/retry/retry_policy_test.dart,分别覆盖数值差异和意外异常。

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

运行扩展输出,便于看到每个测试的名称和错误上下文。

bash
dart test test/retry/retry_policy_test.dart -r expanded

预期结果(关键片段,<TIME>、<PATH> 和 <LINE> 的实际值可能不同)

text
<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 中对应实现,再由原测试验证。

dart
int retryDelayMs(int retryIndex) {
  return (retryIndex + 1) * 100;
}

int parseRetryCount(String raw) {
  return int.tryParse(raw) ?? 0;
}

再次运行原来的测试命令:

bash
dart test test/retry/retry_policy_test.dart -r expanded

预期输出

text
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!

时间前缀可能不同,但两个原失败用例都应转为通过。排查测试失败时,最可靠的顺序是先识别失败类型,再锁定项目调用帧,最后用同一条测试命令验证修复,而不是只凭修改后的代码“看起来正确”就结束。

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

目录与阅读设置

阅读设置

17

记录一个想法

读懂测试失败输出与堆栈

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

登录哪都通