Flutter使用Snapshot访问Firebase数据提示documents属性不存在错误如何解决

报错的根本原因有两点：

• 空安全限制：Dart空安全机制不允许直接访问可空类型的属性，你当前的snapshot.data没有做非空校验，Dart判定其可能为null，所以直接访问属性会触发报错。
• API更名：cloud_firestore依赖从2.0.0版本开始，原来QuerySnapshot类下的documents属性已经更名为docs，并不是移除了该属性。

修正后的完整代码 #

Widget build(BuildContext context) {
  return Scaffold(
    body: StreamBuilder(
      stream: FirebaseFirestore.instance.collection('chats/wuQaqmmo64XVBVJ6S6ET/messages').snapshots(),
      builder: (ctx, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(
            child: CircularProgressIndicator(),
          );
        }
        // 新增非空判断，处理请求失败无数据的场景
        if (!snapshot.hasData || snapshot.data?.docs == null) {
          return const Center(
            child: Text('暂无聊天数据'),
          );
        }
        // 提取数据，避免重复写非空断言
        final chatDocs = snapshot.data!.docs;
        return ListView.builder(
          // 动态适配数据条数，不要写死固定值，避免数组越界
          itemCount: chatDocs.length,
          itemBuilder: (ctx, index) => Container(
            padding: const EdgeInsets.all(8),
            // 对应索引取数据，不要写死0
            child: Text(chatDocs[index]['text']),
          ),
        );
      },
    ),
  );
}

注意事项 #

• 旧版Firestore.instance的写法也已经废弃，新版统一使用FirebaseFirestore.instance调用实例。
• 如果不想用非空断言!，可以用安全调用+默认值的写法进一步规避崩溃：chatDocs[index].get('text') ?? '无内容'
• 可以提前给StreamBuilder指定泛型StreamBuilder<QuerySnapshot>，避免隐式类型推断带来的额外类型校验问题。

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