Flutter中StreamBuilder如何正确配置builder参数解决类型与空返回报错

报错原因说明 #

• 报错1：The argument type 'Type' can't be assigned to the parameter type 'Widget Function(BuildContext, AsyncSnapshot<QuerySnapshot<Object?>>)'
  触发原因有两个：
  1. builder入参的AsyncSnapshot未指定泛型，和StreamBuilder要求的AsyncSnapshot<QuerySnapshot<Object?>>类型不匹配
  2. Column的children参数要求传入List<Widget>类型，代码中将已为列表的messageWidgets又套了一层数组，导致类型不匹配
• 报错2：The body might complete normally, causing 'null' to be returned, but the return type is a potentially non-nullable type
  触发原因是builder函数要求必须返回非空的Widget，但是代码仅在snapshot.hasData为true时做了返回，当snapshot处于加载、出错、无数据状态时，函数无返回值，会默认返回null，违反了非空类型要求。

修复后代码 #

builder: (BuildContext context, AsyncSnapshot<QuerySnapshot<Object?>> snapshot){
  // 处理加载状态
  if (snapshot.connectionState == ConnectionState.waiting) {
    return const Center(child: CircularProgressIndicator());
  }
  // 处理错误状态
  if (snapshot.hasError) {
    return const Center(child: Text('加载数据出错'));
  }
  // 处理有数据的情况
  if(snapshot.hasData){
    final messages = snapshot.data?.docs ?? [];
    List<Text> messageWidgets = [];
    for(var message in messages){
      final messageText = message.data()['text'];
      final messageSender = message.data()['sender'];
      final messageWidget = Text('$messageText from $messageSender');
      messageWidgets.add(messageWidget);
    }
    return Column(
      // 直接传入messageWidgets，无需额外嵌套数组，若要插入其他组件可配合...展开运算符使用
      children: messageWidgets,
    );
  }
  // 兜底无数据状态
  return const Center(child: Text('暂无消息'));
},

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