如何处理Firestore中DocumentSnapshotPlatform字段不存在的报错？

错误原因 #

直接通过DocumentSnapshot['字段名']方式取值时，若文档内不存在对应字段，Firestore SDK会直接抛出异常，不会返回null，因此无法直接在后续拼接??操作符赋值默认值。

核心解决方法 #

先调用data()方法将文档完整内容转为Map<String, dynamic>类型，Map对不存在的key取值时会默认返回null，此时就可以用??操作符设置默认值，逻辑和shared_preferences的处理完全一致。

修改后的代码示例 #

class UserModel
{
  final String? id;
  final String username; // 存在默认值时可以不用声明为可空
  final String? email;

  UserModel({
    this.id,
    required this.username,
    this.email,
  });

  factory UserModel.fromDocument(DocumentSnapshot doc)
  {
    // 先将文档转为Map格式
    final Map<String, dynamic> data = doc.data() as Map<String, dynamic>;
    return UserModel(
      id: data['id'] as String?,
      // 字段不存在时会返回null，直接用??赋值默认值即可
      username: (data['username'] as String?) ?? "User",
      email: data['email'] as String?,
    );
  }
}

其他可选处理方案 #

• 也可以先通过containsKey判断字段是否存在，再取值：

  username: doc.containsKey('username') ? doc['username'] as String : "User"
  

线上版本迭代的最佳实践 #

• 所有新增非必填字段都要在解析层设置默认值，不要假设字段一定存在
• 若新增字段属于必填项，可以写一次性后台迁移脚本，给所有存量缺失字段的文档补写默认值，避免前端重复做兼容判断
• 取值时优先用as?做类型转换，不要用强制类型断言as，避免字段类型不匹配时抛出类型转换异常

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