修复Flutter Firebase Bad state: field does not exist报错

你遇到的Bad state: field does not exist within the DocumentSnapshotPlatform报错，是因为直接通过documentSnapshot['fieldName']下标语法读取Firestore文档字段时，SDK会校验字段是否存在，字段缺失时直接抛异常，不会返回null。你的新注册用户文档仅存储经纬度，缺少firstName、lastName、email等可选字段，直接读取必然触发报错。

核心逻辑是先把文档快照转成可空的Map集合，读取字段时做存在性判断，缺失时返回预设的占位文本，两种实现方式可选：

推荐：全局扩展方法（一次编写全项目复用） #

在项目公共工具文件中添加DocumentSnapshot扩展，统一处理字段容错逻辑：

extension FirestoreDocExtension on DocumentSnapshot {
  /// 读取字段，字段不存在时返回默认值
  T getField<T>(String fieldKey, T defaultPlaceholder) {
    final docData = data() as Map<String, dynamic>?;
    // 文档为空/字段不存在/字段值为null时，统一返回占位值
    if (docData == null || !docData.containsKey(fieldKey)) {
      return defaultPlaceholder;
    }
    return (docData[fieldKey] as T?) ?? defaultPlaceholder;
  }
}

在PROFILE_SCREEN.dart中读取用户字段时，直接调用扩展方法传入占位文本即可：

// 示例：从用户文档快照中读取字段
final String displayFirstName = userDoc.getField('firstName', '未设置姓名');
final String displayLastName = userDoc.getField('lastName', '');
final String displayEmail = userDoc.getField('email', '未绑定邮箱');
final String displayPhone = userDoc.getField('phone', '未绑定手机号');
// 经纬度是注册必存字段，可直接读取，也可以走扩展加兜底
final double latitude = userDoc.getField('latitude', 0.0);
final double longitude = userDoc.getField('longitude', 0.0);

轻量方案：单字段手动判空 #

如果不想加全局扩展，每次读取字段前先转Map判空即可：

final userData = userDoc.data() as Map<String, dynamic>? ?? const {};
final String displayFirstName = userData['firstName'] ?? '未设置姓名';
final String displayEmail = userData['email'] ?? '未绑定邮箱';
final String displayPhone = userData['phone'] ?? '未绑定手机号';

• 所有非注册必填的用户字段，禁止直接使用[]下标语法读取，必须走带默认值的容错逻辑
• 占位文本可以根据产品需求自定义，比如未设置、未绑定、去完善之类的文案都可以
• 后续如果新增可选用户字段，复用上述逻辑即可，不会再出现字段缺失的报错

内容的提问来源于stack exchange，提问作者Rudransh Singh Mahra