Flutter获取Firestore文档报StateError字段不存在错误如何解决？

该报错本质是DocumentSnapshotPlatform中不存在你调用get()方法请求的字段，或目标文档本身不存在，按以下步骤排查即可解决：

• 先校验目标文档是否存在：调用get()获取快照后先判断doc.exists属性，确认文档存在后再读取字段，避免读取空文档
• 检查字段名拼写：Firestore字段大小写敏感，确认你存储的文档字段名和代码中get()的参数完全一致，无拼写错误、大小写不符或字段缺失的情况
• 用更安全的方式读取字段：不要直接用doc.get()，先把快照数据转为Map再取值，字段不存在时会自动返回null，刚好适配你的Cloth类可空属性，修改后的代码如下：

final docSnapshot = await DatabaseService(uid: uid).clothCollection.doc(uid).get();
Cloth? cloth;
if (docSnapshot.exists) {
  final docData = docSnapshot.data() as Map<String, dynamic>?;
  if (docData != null) {
    cloth = Cloth(
      brand: docData['brand'] as String?,
      name: docData['name'] as String?,
      color: docData['color'] as String?,
      url: docData['url'] as String?,
    );
  }
}

官方推荐使用withConverter方法直接绑定自定义类型和Firestore文档，不需要手动逐个读取字段，操作步骤如下：

1. 给Cloth类新增fromJson、toJson方法：

class Cloth {
  final String? name;
  final String? url;
  final String? brand;
  final String? color;

  Cloth({this.name, this.brand, this.color, this.url});

  Cloth.fromJson(Map<String, dynamic> json) : this(
    name: json['name'] as String?,
    brand: json['brand'] as String?,
    color: json['color'] as String?,
    url: json['url'] as String?,
  );

  Map<String, dynamic> toJson() => {
    'name': name,
    'brand': brand,
    'color': color,
    'url': url,
  };
}

2. 定义clothCollection时添加类型转换：

// 把原来的普通集合声明替换为带转换器的版本
final CollectionReference<Cloth> clothCollection = FirebaseFirestore.instance
    .collection('clothes')
    .withConverter<Cloth>(
      fromFirestore: (snapshot, _) => Cloth.fromJson(snapshot.data()!),
      toFirestore: (cloth, _) => cloth.toJson(),
    );

3. 后续读取文档可直接拿到Cloth类型对象：

final docSnapshot = await DatabaseService(uid: uid).clothCollection.doc(uid).get();
final Cloth? cloth = docSnapshot.data();

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