Flutter中如何安全读取Cloud Firestore数据 避免文档字段缺失报错

doc.get()方法在目标字段不存在时会直接抛出Bad state异常，不会返回null。空值判断符??仅能处理返回值为null的场景，异常抛出阶段早于空值判断执行，所以你写的默认值占位不会生效。

方法1：先将快照数据转为Map再取值 #

Map读取不存在的键会直接返回null，不需要捕获异常，可直接配合??赋值默认值，代码实现如下：

factory User.fromFirestore(DocumentSnapshot doc) {
  final Map<String, dynamic>? data = doc.data() as Map<String, dynamic>?;
  return User(
    id: doc.id,
    email: data?['email'] ?? '',
    displayName: data?['displayName'] ?? '',
    fieldfoo: data?['fieldfoo'] ?? '',
    fieldbar: data?['fieldbar'] ?? [],
  );
}

方法2：封装扩展方法兼容get()调用习惯 #

如果习惯用get()方法读取字段，可以封装扩展方法统一捕获异常、填充默认值：

// 扩展方法定义
extension DocumentSnapshotExt on DocumentSnapshot {
  T getOrDefault<T>(String key, T defaultValue) {
    try {
      final value = get(key);
      return value as T? ?? defaultValue;
    } catch (_) {
      return defaultValue;
    }
  }
}

// 业务代码调用
factory User.fromFirestore(DocumentSnapshot doc) {
  return User(
    id: doc.id,
    email: doc.getOrDefault('email', ''),
    displayName: doc.getOrDefault('displayName', ''),
    fieldfoo: doc.getOrDefault('fieldfoo', ''),
    fieldbar: doc.getOrDefault('fieldbar', []),
  );
}

• 优先使用data()转Map的方案，性能开销比捕获异常更低，逻辑也更直观
• 配合json_serializable等序列化库自动处理字段映射、默认值填充，避免手写取值逻辑出错
• 针对存量缺失字段的老文档，可以批量执行后台数据迁移补全默认值，从数据源层面统一格式，减少客户端兼容逻辑
• 涉及复杂类型字段（如数组、嵌套对象）时，增加类型校验逻辑，避免字段类型不匹配导致的类型转换异常

该问题是cloud_firestore 2.0版本升级后的典型破坏性变更：1.x版本中get()读取不存在字段会返回null，2.0之后调整为直接抛出异常，大量升级SDK的开发者都遇到过同类报错。

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