跨平台开发 / 系统课时

验证异常类型与错误信息

验证异常类型与错误信息

只验证“会抛异常”往往不够:错误类型不对、触发条件偏了,测试仍可能误判通过。本节用 package:test 同时检查同步异常的类型、消息和关键字段,让失败分支像正常返回值一样可验证。

学习目标

  • 用 throwsA 验证同步代码抛出的异常类型
  • 用 isA 与 having 检查稳定的错误信息和字段
  • 避免因直接调用被测函数或断言过宽而产生无效测试

先把异常调用包成函数

同步函数一旦抛异常,当前表达式会立刻中断,因此不能先调用函数再把结果交给 expect。测试异常时,应把调用写成零参数函数,让 throwsA 在断言阶段执行它。

只写 throwsA(anything) 虽然能证明“有东西被抛出”,却无法确认 API 是否抛了约定的异常。更稳的做法是先锁定类型,再检查业务上稳定的字段。

同时验证类型与消息

下面的函数把“不是整数”和“整数但不为正数”区分为两类失败。测试既覆盖正常路径,也分别验证 FormatException 与 ArgumentError。

dart
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):

text
<TIME> +3: All tests passed!

其中 <TIME> 是测试运行耗时,实际值会随机器环境变化。having 不会改变异常本身,它只是从已经匹配到的对象中取一个属性继续断言,因此很适合检查 message、invalidValue 这类稳定字段。

只断言真正属于契约的信息

异常消息如果面向最终用户、协议响应或明确的业务规则,验证完整文本很有价值;如果消息只是开发期诊断文本,逐字匹配会让测试过于脆弱。此时可以只验证类型,或只检查不会随实现细节变化的字段。

还要注意触发条件。比如“零值必须失败”的测试应传入 0,不要只用任意负数替代,否则边界条件仍未被覆盖。异常测试的目标不是制造一次失败,而是证明特定输入会以约定方式失败。

常见误写

最常见的问题是把 parsePositiveInt('abc') 直接传给 expect。这样异常会在 matcher 接管之前就抛出,测试无法按预期验证。另一个问题是只写 throwsA(isA<Exception>()):类型范围太宽时,错误实现也可能通过。

当接口已经约定异常类型时,优先断言具体类型;当错误对象还携带稳定字段时,再补充 having。这样既能守住失败分支的契约,又不会把测试绑死在无关的内部实现上。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证异常类型与错误信息

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

登录哪都通