在Flutter类中配置GeoPoint时Firestore快照字段不存在报错如何解决

错误原因 #

该异常触发的核心原因是Firestore的DocumentSnapshotPlatform在读取不存在的字段时会直接抛出错误，不会返回null。你去掉location字段读取逻辑后代码可正常运行，说明你的Firestore集合内有部分文档缺失location字段，或是该字段的名称拼写和代码内读取的名称不匹配。

解决方案 #

• 第一步先检查Firestore对应集合的所有文档，确认location字段的拼写、大小写完全和代码一致，排查是否存在部分文档未填写该字段的情况。
• 第二步改造快照转换代码，先将文档转为Map再读取字段，提前判断字段是否存在，避免直接读取抛出异常：

List<Location> _locationListFromSnapshot(QuerySnapshot snapshot) {
    return snapshot.docs.map((doc) {
      Map<String, dynamic> docData = doc.data() as Map<String, dynamic>;
      return Location(
          name: docData["name"]?["ru"] ?? '',
          route: docData["route"] ?? '',
          address: docData["address"]?["ru"] ?? '',
          images: docData["images"] ?? [],
          id: docData['id'] ?? '',
          location: docData.containsKey("location") ? docData["location"] : null
      );
    }).toList();
}

• 如果你使用的是Flutter空安全版本，需要同步调整Location模型类的字段定义，允许可空类型：

class Location {
  final String name;
  final String route;
  final String id;
  final GeoPoint? location;
  final List? images;
  final String address;

  Location({
    required this.name,
    required this.route,
    required this.id,
    this.location,
    this.images,
    required this.address
  });
}

补充说明：改造后的代码额外添加了空安全调用符?读取嵌套字段，避免name、address字段本身为null时抛出空异常，同时给images字段添加了默认空数组的兜底逻辑，减少其他潜在崩溃风险。

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