Flutter连接Firebase数据库出现Bad State错误：字段存在仍报错

以下是针对你遇到的问题的排查和解决方法：

1. 排查文档是否真的包含目标字段 #

即使你确认大部分文档有name字段，也可能存在个别缺失的情况。先添加打印语句验证所有文档的数据：

// 在转换为items列表前加入
documents.forEach((doc) {
  print('文档ID: ${doc.id}, 完整数据: ${doc.data()}');
});

如果发现有文档缺少name，要么在Firestore后台补全字段，要么在代码中做容错处理：

// 方式1：使用get方法设置默认值
List<Map> items = documents.map((e) => {
  'name': e.get('name', defaultValue: '未命名'),
}).toList();

// 方式2：判断字段是否存在
List<Map> items = documents.map((e) => {
  'name': (e.data() as Map).containsKey('name') ? e['name'] : '未命名',
}).toList();

2. 检查字段名称大小写 #

Firestore的字段名区分大小写，确认数据库中的字段是小写name，而不是Name、NAME等其他形式。

3. 验证Firestore权限规则 #

如果你的应用未配置正确的读取权限，可能导致部分文档无法被读取，进而出现字段缺失的错误。可以临时设置测试规则（上线前务必修改为安全规则）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

4. 确认数据流的集合路径正确 #

检查_stream变量对应的集合路径是否和Firestore中的集合名称一致，比如：

final _stream = FirebaseFirestore.instance.collection('items').snapshots();

如果集合名写错，读取到的文档结构自然不匹配。

5. 推荐使用强类型模型（降低出错概率） #

对于新手，用强类型类来封装Firestore文档数据能有效避免字段错误。创建一个Item类：

class Item {
  final String name;

  Item({required this.name});

  factory Item.fromFirestore(DocumentSnapshot doc) {
    final data = doc.data() as Map<String, dynamic>;
    return Item(
      name: data['name'] ?? '未命名',
    );
  }
}

然后修改代码中的数据转换逻辑：

// 替换原来的map代码
List<Item> items = documents.map((e) => Item.fromFirestore(e)).toList();

// ListView中使用
return ListTile(
  title: Text(items[index].name)
);

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