Flutter使用cloud_firestore时DocumentSnapshot空安全报错如何解决？

报错根本原因 #

这是Dart空安全机制的常规校验：

1. FutureBuilder的snapshot.data是可空类型，哪怕你提前用if(!snapshot.hasData)做了非空判断，编译器也不会默认把snapshot.data提升为非空类型，直接传给要求入参非空的MyUser.fromDocument方法就会触发类型不匹配报错。
2. 你后续尝试调用snapshot.data.data()报错，是因为没有先对可空的snapshot.data做非空处理，空对象调用方法自然会触发空安全校验。

最简解决方案 #

你已经提前判断了接口返回有数据，直接对snapshot.data加**非空断言!**即可，不需要额外修改其他逻辑：

// 把原来的赋值行改成下面这样即可
MyUser user = MyUser.fromDocument(snapshot.data!);

更规范的优化方案（可选） #

如果要避免后续同类空安全问题、类型更严谨，可以按下面的步骤修改全链路代码：

1. 给usersRef指定泛型类型，明确存储的是键值对结构：

final CollectionReference<Map<String, dynamic>> usersRef = FirebaseFirestore.instance.collection('users');

2. 调整MyUser的工厂方法入参类型，直接读取结构化的文档数据：

factory MyUser.fromDocument(DocumentSnapshot<Map<String, dynamic>> doc){
  final docData = doc.data()!;
  return MyUser(
    id: docData['id'].toString(),
    username: docData['username'].toString(),
    email: docData['email'].toString(),
    photoUrl: docData['photoUrl'].toString(),
    displayName: docData['displayName'].toString(),
  );
}

3. 调整FutureBuilder的泛型匹配：

return FutureBuilder<DocumentSnapshot<Map<String, dynamic>>>(
  future: usersRef.doc(myuser.id).get(),
  builder: (context, snapshot) {
    if(!snapshot.hasData){
      return circularProgress();
    }
    // 额外加文档存在性判断更稳妥
    if(!snapshot.data!.exists){
      return const Text("用户不存在");
    }
    MyUser user = MyUser.fromDocument(snapshot.data!);
    return Row(...);
  }
);

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