Flutter Firestore查询用户数据报错：无法用[]访问QuerySnapshot数据

你遇到的错误原因是：QuerySnapshot是查询结果的集合容器，它包含了所有匹配查询条件的文档，本身不是单个文档的Map数据，所以不能直接用[]访问字段。必须先从QuerySnapshot的docs列表中取出对应的DocumentSnapshot，再通过data()方法获取文档的Map数据，才能访问具体字段。

方式一：用get()单次获取数据 #

适合只需要加载一次数据的场景，代码示例：

// 先获取当前登录的Firebase用户
final currentUser = FirebaseAuth.instance.currentUser;
if (currentUser != null) {
  final userEmail = currentUser.email;
  // 执行查询：匹配users集合中1_email字段等于当前用户邮箱的文档
  final queryResult = await FirebaseFirestore.instance
      .collection('users')
      .where('1_email', isEqualTo: userEmail)
      .get();
  
  // 检查是否有匹配的文档（邮箱唯一的话，应该只有一个结果）
  if (queryResult.docs.isNotEmpty) {
    // 取出第一个匹配的文档
    final userDocument = queryResult.docs.first;
    // 获取文档的Map格式数据
    final userData = userDocument.data();
    // 访问具体字段
    print(userData['1_email']);
    // 其他字段同理，比如userData['1_name']、userData['1_age']等
  } else {
    print('未找到与当前用户匹配的数据');
  }
} else {
  print('用户未登录');
}

方式二：用snapshots()实时监听数据 #

适合需要实时同步Firestore数据变化的场景，通常配合StreamBuilder使用：

StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
  // 构建实时监听的流
  stream: FirebaseFirestore.instance
      .collection('users')
      .where('1_email', isEqualTo: FirebaseAuth.instance.currentUser?.email)
      .snapshots(),
  builder: (context, snapshot) {
    // 处理错误状态
    if (snapshot.hasError) {
      return Text('加载失败：${snapshot.error}');
    }
    // 处理加载中状态
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }
    // 获取所有匹配的文档列表
    final userDocs = snapshot.data?.docs ?? [];
    if (userDocs.isEmpty) {
      return const Text('未找到用户数据');
    }
    // 取出第一个文档并获取数据
    final userData = userDocs.first.data();
    // 用数据构建UI
    return Column(
      children: [
        Text('邮箱：${userData['1_email']}'),
        Text('昵称：${userData['1_name']}'),
        // 其他字段按需添加
      ],
    );
  },
)

额外优化建议 #

如果你的users集合是用用户UID作为文档ID的，可以直接通过文档ID查询，效率更高：

final userDoc = await FirebaseFirestore.instance
    .collection('users')
    .doc(currentUser!.uid)
    .get();
final userData = userDoc.data();

这种方式不需要用where查询，直接定位到单个文档，返回的是DocumentSnapshot，可以直接调用data()获取字段数据。

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