调用NetworkImage显示网络图片时为何触发Invalid Argument Exception？

数据老陈

2026-6-22

问题描述

调用以下代码时，有时会收到异常提示：

Widget displayImage(BuildContext context, MyBook book) {
  if (book.coverUrl != null) {
    try {
      return Image.network(book.coverUrl!,
          errorBuilder: (context, error, stackTrace) {
        return Text('No \nimage');
      });
    } on Exception {
      return Text('No \nImage');
    }
  } else {
    return Text('No \nImage');
  }
}

收到的异常信息：

════════ 图片资源服务捕获到异常 ══════════════════
Invalid argument(s): No host specified in
URI file:///home/alan/FlutterProjects/books/null
════════════════════════════════════════════════════════

（file:///home/alan/FlutterProjects/books/是应用路径，book.coverUrl为String类型。）
尽管抛出异常，在线图片仍能正常显示。

补充说明：栈追踪末尾还包含以下信息：

Image provider: NetworkImage("null", scale: 1.0)
Image key: NetworkImage("null", scale: 1.0)

请问该异常是什么原因导致的？是否需要修复？

原因分析

核心问题：book.coverUrl是字符串"null"而非Dart的null
代码通过book.coverUrl != null判断是否加载图片，但实际场景中book.coverUrl的值是字符串字面量"null"，而非Dart语言中的null对象。这导致条件判断通过，执行Image.network("null")。
Flutter的NetworkImage会尝试解析这个"null"字符串作为URL，由于它不是合法的网络地址，最终生成了错误的本地URI（file:///.../null），因此抛出"No host specified"（未指定主机）的异常。
图片仍能正常显示的原因
因为配置了errorBuilder回调，当NetworkImage加载失败时，该回调会触发并显示"No image"文本。而控制台的异常是Flutter框架在图片资源服务层面捕获并打印的，不会阻断errorBuilder的执行，也不会导致应用崩溃。

是否需要修复？

需要修复，理由如下：

控制台的异常日志会干扰日常调试，增加排查其他问题的复杂度；
发起无效的网络请求会浪费不必要的系统资源（比如无意义的网络连接尝试）。

修复方案

修改判断逻辑，同时排除null、空字符串、"null"字面量这几种无效情况：

Widget displayImage(BuildContext context, MyBook book) {
  final coverUrl = book.coverUrl;
  // 同时校验非null、非空、非"null"字符串
  if (coverUrl != null && coverUrl.isNotEmpty && coverUrl.toLowerCase() != "null") {
    return Image.network(coverUrl,
        errorBuilder: (context, error, stackTrace) {
      return Text('No \nimage');
    });
  } else {
    return Text('No \nImage');
  }
}

另外，原代码中的try-catch块实际无效，因为Image.network的加载异常是在Flutter异步图片资源服务中抛出的，无法被当前同步代码的try-catch捕获，所以可以直接移除。

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