Flutter开发中Firebase snapshot三类报错场景解决方案求助

这些报错基本都是cloud_firestore 2.0+版本升级后带来的空安全、类型强校验、API变更导致的，旧教程的写法已经不兼容新版本，以下是对应场景的修复方案：

通用前置调整 #

所有FutureBuilder/StreamBuilder都必须明确指定snapshot的泛型类型，不要让Dart推断为dynamic类型，这是80%同类型报错的根源。

第一个场景报错修复 #

报错原因 #

1. 未给FutureBuilder指定泛型，snapshot.data被推断为dynamic类型，无法识别docs属性
2. ListView.children要求传入List<Widget>类型，直接传入文档列表类型不匹配，需要把每一个文档转换为对应的Widget组件

修复后代码 #

Widget build(BuildContext context) {
  return Scaffold(
    backgroundColor: Colors.orange,
    appBar: header(context, titleText: "Activity Feed"),
    body: Container(
      // 此处泛型和getActivityFeed返回值类型保持一致即可
      child: FutureBuilder<QuerySnapshot>(
        future: getActivityFeed(),
        builder: (context, AsyncSnapshot<QuerySnapshot> snapshot) {
          if (!snapshot.hasData) {
            return circularProgress();
          }
          return ListView(
            // 遍历docs转换为Widget列表，可替换为你自己的业务列表项组件
            children: snapshot.data!.docs.map((doc) {
              return ListTile(title: Text(doc['content']));
            }).toList(),
          );
        },
      ),
    ),
  );
}

第二个场景报错修复 #

报错原因 #

cloud_firestore 2.0+版本后，DocumentSnapshot的取值逻辑变更，需要额外调用一次data()方法才能拿到文档的Map结构数据，同时要做空安全校验。

• 若当前snapshot是AsyncSnapshot<DocumentSnapshot>（来自Future/StreamBuilder的参数），需要先取到内层的DocumentSnapshot再调用data()
• 若当前snapshot本身就是DocumentSnapshot类型，直接补全调用即可

修复后代码 #

如果你的User.fromDocument入参是Map类型：

User user = User.fromDocument(snapshot.data!.data()!);

如果你的User.fromDocument入参是DocumentSnapshot类型：

User user = User.fromDocument(snapshot.data!);

第三个场景报错修复 #

报错原因 #

未给snapshot指定泛型，snapshot.data!.docs被推断为dynamic类型，遍历时无法识别元素为DocumentSnapshot类型。

修复后代码 #

// 首先确保当前作用域里的snapshot是明确的AsyncSnapshot<QuerySnapshot>类型
List<UserResult> userResults = [];
// 也可以给doc加明确类型声明避免报错：(QueryDocumentSnapshot doc)
snapshot.data!.docs.forEach((doc) {
  User user = User.fromDocument(doc);
  final bool isAuthUser = currentUser.id == user.id;
  final bool isFollowingUser = followingList.contains(user.id);
  // 移除当前登录用户的推荐
  if (isAuthUser) {
    return;
  } else if (isFollowingUser) {
    return;
  } else {
    UserResult userResult = UserResult(user);
    userResults.add(userResult);
  }
});

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