Flutter Image.network集成测试因404异常失败的解决方案问询

你的场景中，Image.network的errorBuilder能在发布模式下正常处理404并显示占位图，但集成测试时NetworkImageLoadException会被测试框架判定为未捕获异常，导致测试失败。以下是两种可行的解决方案：

方案1：在集成测试中拦截并忽略指定异常 #

直接在测试入口文件中配置全局错误处理，过滤掉图片加载404的异常：

import 'package:flutter/material.dart';
import 'package:flutter/src/painting/image_provider.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:your_app/main.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  setUpAll(() {
    // 重写Flutter错误处理逻辑
    FlutterError.onError = (FlutterErrorDetails details) {
      // 判定是否为图片加载404异常
      if (details.exception is NetworkImageLoadException &&
          (details.exception as NetworkImageLoadException).statusCode == 404) {
        // 忽略该异常，不触发测试失败
        debugPrint('忽略图片加载404异常');
        return;
      }
      // 其他异常按默认逻辑上报
      FlutterError.presentError(details);
    };
  });

  testWidgets('验证物品图片展示逻辑', (WidgetTester tester) async {
    await tester.pumpWidget(const YourApp());
    // 执行你的测试断言逻辑...
  });
}

这个方案不会影响生产代码，仅在测试环境中生效，能精准过滤目标异常，同时保留其他错误的正常上报。

方案2：封装安全的网络图片组件 #

如果希望在组件层面处理异常，避免测试框架捕获到错误，可以封装一个自定义组件，利用imageErrorListener捕获404异常：

import 'package:flutter/material.dart';
import 'package:flutter/src/painting/image_provider.dart';

class SafeNetworkImage extends StatelessWidget {
  final String pictureUri;
  final String noPictureAssetUri;

  const SafeNetworkImage({
    super.key,
    required this.pictureUri,
    required this.noPictureAssetUri,
  });

  @override
  Widget build(BuildContext context) {
    return Image.network(
      pictureUri,
      errorBuilder: (context, error, stackTrace) => Image.asset(noPictureAssetUri),
      imageErrorListener: (exception, stackTrace) {
        // 捕获并忽略404异常
        if (exception is NetworkImageLoadException && exception.statusCode == 404) {
          debugPrint('图片加载失败（404），已显示占位图');
        }
      },
    );
  }
}

之后替换原有的Image.network为SafeNetworkImage即可。不过需要注意，部分测试场景下，框架仍可能检测到底层异常，因此方案1的可靠性更高。

内容的提问来源于stack exchange，提问作者MartinYakuza