跨平台开发 / 系统课时
验证异常类型与错误信息
验证异常类型与错误信息
只验证“会抛异常”往往不够:错误类型不对、触发条件偏了,测试仍可能误判通过。本节用 package:test 同时检查同步异常的类型、消息和关键字段,让失败分支像正常返回值一样可验证。
学习目标
- 用
throwsA验证同步代码抛出的异常类型 - 用
isA与having检查稳定的错误信息和字段 - 避免因直接调用被测函数或断言过宽而产生无效测试
先把异常调用包成函数
同步函数一旦抛异常,当前表达式会立刻中断,因此不能先调用函数再把结果交给 expect。测试异常时,应把调用写成零参数函数,让 throwsA 在断言阶段执行它。
只写 throwsA(anything) 虽然能证明“有东西被抛出”,却无法确认 API 是否抛了约定的异常。更稳的做法是先锁定类型,再检查业务上稳定的字段。
同时验证类型与消息
下面的函数把“不是整数”和“整数但不为正数”区分为两类失败。测试既覆盖正常路径,也分别验证 FormatException 与 ArgumentError。
import 'package:test/test.dart';
int parsePositiveInt(String raw) {
final value = int.tryParse(raw);
if (value == null) {
throw FormatException('not an integer: $raw');
}
if (value <= 0) {
throw ArgumentError.value(
value,
'raw',
'must be greater than 0',
);
}
return value;
}
void main() {
group('parsePositiveInt', () {
test('returns a positive integer', () {
expect(parsePositiveInt('42'), 42);
});
test('throws FormatException for non-integer input', () {
expect(
() => parsePositiveInt('abc'),
throwsA(
isA<FormatException>().having(
(error) => error.message,
'message',
'not an integer: abc',
),
),
);
});
test('throws ArgumentError for zero', () {
expect(
() => parsePositiveInt('0'),
throwsA(
isA<ArgumentError>()
.having(
(error) => error.invalidValue,
'invalidValue',
0,
)
.having(
(error) => error.message,
'message',
'must be greater than 0',
),
),
);
});
});
}预期输出(保存为 test/parse_positive_int_test.dart 后执行 dart test test/parse_positive_int_test.dart):
<TIME> +3: All tests passed!其中 <TIME> 是测试运行耗时,实际值会随机器环境变化。having 不会改变异常本身,它只是从已经匹配到的对象中取一个属性继续断言,因此很适合检查 message、invalidValue 这类稳定字段。
只断言真正属于契约的信息
异常消息如果面向最终用户、协议响应或明确的业务规则,验证完整文本很有价值;如果消息只是开发期诊断文本,逐字匹配会让测试过于脆弱。此时可以只验证类型,或只检查不会随实现细节变化的字段。
还要注意触发条件。比如“零值必须失败”的测试应传入 0,不要只用任意负数替代,否则边界条件仍未被覆盖。异常测试的目标不是制造一次失败,而是证明特定输入会以约定方式失败。
常见误写
最常见的问题是把 parsePositiveInt('abc') 直接传给 expect。这样异常会在 matcher 接管之前就抛出,测试无法按预期验证。另一个问题是只写 throwsA(isA<Exception>()):类型范围太宽时,错误实现也可能通过。
当接口已经约定异常类型时,优先断言具体类型;当错误对象还携带稳定字段时,再补充 having。这样既能守住失败分支的契约,又不会把测试绑死在无关的内部实现上。