实现Bloc模式对接API时报错：type 'Future<dynamic>' is not a subtype of type 'Widget?'

错误根源 #

type 'Future' is not a subtype of type 'Widget?' 报错的直接原因是BlocBuilder的builder回调要求必须返回一个Widget对象，但你在加载状态分支返回了LoadingDialog.showLoadingDialog(context, text: "")，这个方法是异步方法，返回的是Future类型而非Widget，不符合类型要求。
通常这类命名为showXxxDialog的方法内部调用了系统showDialog函数，本身返回Future用于监听弹窗关闭事件，作用是弹出浮层弹窗，不是用来作为组件嵌入Widget树的。

修复方案 #

方案1：替换为加载组件（推荐） #

如果只需要在页面内展示加载状态，直接返回静态加载组件即可：

} else {
  return const Center(
    // 可替换为你自定义的加载Widget
    child: CircularProgressIndicator(),
  );
}

方案2：用BlocListener处理弹窗逻辑 #

如果确实需要弹出全局加载弹窗，不要将弹窗方法放在BlocBuilder的返回值中，添加BlocListener监听状态变化来处理弹窗：

// 在BlocBuilder外层嵌套BlocListener
BlocListener<VehiclesBloc, VehiclesState>(
  listener: (context, state) {
    if (state is VehiclesLoading) {
      LoadingDialog.showLoadingDialog(context, text: "");
    } else {
      // 加载完成/失败时关闭弹窗
      Navigator.pop(context);
    }
  },
  child: BlocBuilder<VehiclesBloc,VehiclesState>(
    // 原builder逻辑不变，加载状态可以返回空的SizedBox
  )
)

额外优化建议 #

你当前Bloc代码中mapLoadEventToState的参数已经是LoadVehiclesList类型，方法内的if(event is LoadVehiclesList)判断冗余，else分支永远不会触发，可以直接删除冗余代码，不影响功能运行。

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