Flutter中如何用WidgetTester捕获Widgets Library抛出的UnimplementedError？

你在测试组件抛出UnimplementedError时遇到的问题，核心原因是Flutter Widget框架会自动捕获build阶段抛出的异常，这些异常不会冒泡到普通的try/catch或常规的expect断言逻辑中，导致你写的测试无法正确捕获目标异常。

正确的测试实现方式 #

通过监听FlutterError.onError回调，拦截框架捕获的异常，再进行断言验证：

import 'package:flutter_test/flutter_test.dart';
import 'package:flutter/material.dart';

// 示例抛出异常的组件
class WidgetThatThrowUnimplementedError extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    throw UnimplementedError();
  }
}

void main() {
  testWidgets('组件应抛出UnimplementedError', (WidgetTester tester) async {
    UnimplementedError? capturedError;
    // 保存原始的错误处理逻辑，测试后恢复
    final originalOnError = FlutterError.onError;

    // 临时替换错误处理回调，捕获目标异常
    FlutterError.onError = (FlutterErrorDetails details) {
      capturedError = details.exception as UnimplementedError;
      // 如果不需要在控制台打印错误日志，可以注释掉下面一行
      // originalOnError?.call(details);
    };

    // 渲染抛出异常的组件
    await tester.pumpWidget(WidgetThatThrowUnimplementedError());

    // 断言捕获到的异常类型正确
    expect(capturedError, isA<UnimplementedError>());

    // 恢复原始错误处理逻辑，避免影响其他测试
    FlutterError.onError = originalOnError;
  });
}

为什么之前的方法无效？ #

• 直接用try/catch包裹pumpWidget：Widget构建时的异常被Flutter框架通过FlutterError捕获，不会进入你的catch块，所以代码会执行到fail('Exception was not thrown')，导致测试失败。
• 注释掉的expect(() async { ... }, throwsA(...))：这种方式只能捕获异步函数本身抛出的异常，但组件build的异常被框架拦截，不会从pumpWidget方法中抛出，因此同样无法捕获。

内容的提问来源于stack exchange，提问作者Александр Савин