Flutter中Image.network在DecorationImage内时errorBuilder未被调用原因

errorBuilder是Image组件专属的构建阶段回调，不属于底层的图片加载类ImageProvider。
你写Image.network(...).image的时候，传给DecorationImage的只是剥离了外层Image组件的NetworkImage图片加载实例，整个Image组件从来没被插入到渲染树里，它上面配的所有和组件构建相关的回调——errorBuilder、loadingBuilder、frameBuilder全都会失效，不可能被触发。
DecorationImage拿到图片加载实例后会自行走加载流程，出异常了只会调用自己暴露的onError回调，完全感知不到你之前在Image组件上配置过什么错误处理逻辑。

你可以用更简单的实现替代直接传ImageProvider给DecorationImage的写法，既实现和DecorationImage一致的显示效果，又能正常触发errorBuilder：

• 如果不需要做图片和背景的混合效果（比如颜色滤镜、混合模式），直接把Image.network作为Container的child，给Container设置clipBehavior: Clip.hardEdge，配合圆角、边框配置，就能实现和DecorationImage完全一致的显示效果，此时Image组件是正常挂载在渲染树上的，errorBuilder可以正常触发，加载失败时直接返回自定义的错误提示组件即可。
• 如果必须用到DecorationImage的特殊装饰能力，可以手动创建ImageStream监听图片加载状态，根据加载成功/失败的结果，动态切换Container的decoration和child内容：加载成功时挂载带目标图片的DecorationImage，加载失败时直接在child位置放自定义错误组件。

import 'package:flutter/material.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  static const String _title = 'Flutter Code Sample';

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: _title,
      home: Scaffold(
        body: Center(
          child: MyStatelessWidget(),
        ),
      ),
    );
  }
}

class MyStatelessWidget extends StatelessWidget {
  const MyStatelessWidget({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Container(
      // 自动裁切子组件到圆角范围，效果和DecorationImage一致
      clipBehavior: Clip.hardEdge,
      decoration: BoxDecoration(
          color: Colors.white,
          border: Border.all(),
          borderRadius: BorderRadius.circular(20),
      ),
      child: SizedBox(
        height: 200,
        width: 200,
        child: Image.network(
          'https://example.does.not.exist/image.jpg',
          fit: BoxFit.cover,
          errorBuilder: (BuildContext context, Object exception, StackTrace? stackTrace) {
            // 此处逻辑可正常触发
            return const Center(child: Text('图片加载失败'));
          },
        ),
      ),
    );
  }
}

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