You need to enable JavaScript to run this app. Flutter中FadeInImage.assetNetwork加载错误URL的异常如何处理?
优惠活动
大模型
产品
解决方案
定价
更多

Flutter中FadeInImage.assetNetwork加载错误URL的异常如何处理?

问题根因

这个type 'Null' is not a subtype of type 'List<int>'报错是Flutter 2.x到3.2版本区间network_image_io的官方已知bug,当错误的图片URL返回空响应时,底层网络图片解析逻辑没有做空值校验就强制做类型转换,就会触发该异常。由于图片加载是异步任务,即使你跳转离开当前页面,之前发起的请求回调依然会执行,所以会出现跨页面打印报错的情况,并非页面重绘导致。

修复方案

方案1:升级Flutter版本(最彻底)

该bug已经在Flutter 3.3及以上稳定版修复,直接将你的Flutter SDK升级到3.3+版本即可原生解决该问题。

方案2:替换为CachedNetworkImage组件

如果暂时无法升级SDK,可以改用社区成熟的图片加载库组件,内部已经做了全链路异常捕获,不会触发底层空转换报错,示例代码如下:

CachedNetworkImage(
  placeholder: (context, url) => Image.asset(
    'assets/images/default_360_360.png',
    height: ScreenUtil.fitWidthStatic(320),
    width: ScreenUtil.fitWidthStatic(320),
    fit: BoxFit.cover,
  ),
  errorWidget: (context, url, error) => Image.asset(
    'assets/images/default_360_360.png',
    height: ScreenUtil.fitWidthStatic(320),
    width: ScreenUtil.fitWidthStatic(320),
    fit: BoxFit.cover,
  ),
  imageUrl: widget.model.image ?? '',
  height: ScreenUtil.fitWidthStatic(320),
  width: ScreenUtil.fitWidthStatic(320),
  fit: BoxFit.cover,
)

方案3:原生组件做空值前置校验

如果不想引入第三方库,可以给原生FadeInImage的图片提供者参数提前做空值和合法性校验,避免无效请求发起,示例代码如下:

FadeInImage(
  placeholder: const AssetImage('assets/images/default_360_360.png'),
  image: (widget.model.image?.isNotEmpty ?? false) 
      ? NetworkImage(widget.model.image!) 
      : const AssetImage('assets/images/default_360_360.png') as ImageProvider,
  height: ScreenUtil.fitWidthStatic(320),
  width: ScreenUtil.fitWidthStatic(320),
  imageErrorBuilder: (context, error, stackTrace) {
    return Image.asset(
      'assets/images/default_360_360.png',
      height: ScreenUtil.fitWidthStatic(320),
      width: ScreenUtil.fitWidthStatic(320),
      fit: BoxFit.cover,
    );
  },
  fit: BoxFit.cover,
)

如果需要彻底避免页面销毁后的异步报错,可以在页面State的dispose生命周期中清除对应图片的缓存请求:

@override
void dispose() {
  if (widget.model.image?.isNotEmpty ?? false) {
    PaintingBinding.instance.imageCache.evict(NetworkImage(widget.model.image!));
  }
  super.dispose();
}

内容的提问来源于stack exchange,提问作者user6299706

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 18:54:02