Flutter中Image.file的Invalid Image Data异常无法捕获的原因？

• Image.file的构造函数仅负责创建Widget实例，并不会立即执行图片的加载或解码操作。实际的图片解码、渲染逻辑是Flutter框架在后续的渲染流程中异步执行的，这个过程已经脱离了你当前try-catch代码块的执行上下文，因此异常无法被捕获。
• 你的try-catch只能捕获创建Widget时同步抛出的异常，但图片损坏的错误发生在框架后续的渲染阶段，超出了该捕获范围。

有两种常用的处理方案：

方案1：使用Image.file的errorBuilder参数 #

这是Flutter官方推荐的图片加载失败处理方式，直接在Image组件内部处理错误场景：

Widget getPhotoFile(String path) {
  final file = File(path);

  if (!file.existsSync()) {
    return const Text('No Image');
  }

  return Image.file(
    key: UniqueKey(),
    file,
    fit: BoxFit.cover,
    errorBuilder: (context, error, stackTrace) {
      return const Text('No Image');
    },
  );
}

方案2：提前同步验证图片数据 #

如果需要在返回Widget前就完成图片有效性验证，可以先读取文件内容并尝试解码，将异常捕获在当前方法内：

import 'package:flutter/services.dart';

Widget getPhotoFile(String path) {
  final file = File(path);

  try {
    if (!file.existsSync()) throw Exception('Photo Not Available');

    // 提前读取文件字节并同步解码验证，失败会抛出异常
    final bytes = file.readAsBytesSync();
    decodeImageFromList(bytes);

    return Image.file(
      key: UniqueKey(),
      file,
      fit: BoxFit.cover,
    );

  } catch (error) {
    return const Text('No Image');
  }
}

注意：decodeImageFromList需要导入package:flutter/services.dart，且同步解码大图片可能阻塞UI线程，该方式更适合小体积图片，大图优先推荐使用errorBuilder。

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