Flutter调用snapshot.data()['xxx']读取Firestore数据出现两类报错如何解决？

• 首次空安全报错：DocumentSnapshot.data() 返回值为 Object? 类型，存在为null的可能（比如对应ID的文档不存在时就会返回null），Dart空安全规则不允许直接对可能为null的值调用[]运算符。
• 加!后的运算符不存在报错：data()默认返回的泛型是Object，该类型没有定义下标访问运算符[]，只有强转为Map<String, dynamic>类型后才能通过下标读取字段值。

稳妥全兼容写法（推荐） #

包含文档存在校验、类型转换、空值兜底逻辑，不会出现运行时异常：

DocumentSnapshot snapshot = await FirebaseFirestore.instance.collection("users").doc(user.uid).get();
if (snapshot.exists) {
  // 先将返回结果强转为Map类型
  final userMap = snapshot.data() as Map<String, dynamic>;
  // 读取字段并处理空值
  final location = userMap["location"] as String?;
  print(location ?? "未设置位置信息");
} else {
  print("对应用户文档不存在");
}

简化写法 #

确认文档一定存在、location字段一定存在且为String类型时可以使用：

DocumentSnapshot snapshot = await FirebaseFirestore.instance.collection("users").doc(user.uid).get();
print((snapshot.data() as Map<String, dynamic>)["location"] as String);

进阶优化方案 #

如果需要频繁操作用户集合数据，建议使用官方提供的withConverter方法直接映射为实体类，避免每次手动强转：

// 定义用户实体类
class User {
  final String? location;
  User({this.location});

  static User fromFirestore(DocumentSnapshot<Map<String, dynamic>> snap) {
    final data = snap.data()!;
    return User(location: data["location"] as String?);
  }

  Map<String, Object?> toFirestore() {
    return {"location": location};
  }
}

// 查询时直接转换为实体类
final userRef = FirebaseFirestore.instance
    .collection("users")
    .doc(user.uid)
    .withConverter(
      fromFirestore: (snap, _) => User.fromFirestore(snap),
      toFirestore: (User user, _) => user.toFirestore(),
    );
final snapshot = await userRef.get();
print(snapshot.data()?.location);

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