Flutter开发中如何正确从Firebase获取当前用户的contacts数组

核心错误原因 #

你当前的写法存在两处核心问题：

• get()方法执行后返回的是QuerySnapshot类型对象，并非直接的用户文档数据。使用where条件查询的结果是文档集合，哪怕只有一条匹配文档，也需要先从返回结果中提取对应文档，再读取字段值
• 你的代码中字段名写为contacs，存在拼写错误，和Firestore中存储的contacts字段名不匹配，也会导致读取失败

修正后的代码 #

适配where查询的写法 #

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_auth/firebase_auth.dart';

// 声明变量时指定类型，方便后续类型检查，默认赋值空数组避免空安全问题
List<dynamic> contacts = [];
final String currentUser = FirebaseAuth.instance.currentUser!.uid;

Future<void> getUserData() async {
  // 加limit(1)优化查询性能，uid唯一只需要返回1条结果
  final QuerySnapshot userQuery = await FirebaseFirestore.instance
      .collection('users')
      .where('uid', isEqualTo: currentUser)
      .limit(1)
      .get();
  
  if (userQuery.docs.isNotEmpty) {
    // 提取第一个文档的内容
    final Map<String, dynamic> userData = userQuery.docs.first.data() as Map<String, dynamic>;
    // 读取contacts数组，空值兜底为空白数组
    contacts = userData['contacts'] ?? [];
    // 若在StatefulWidget中调用，读取完成后调用setState刷新UI
    // setState(() {});
  }
}

更高效的推荐写法 #

如果你的users集合的文档ID就是用户的uid，不需要用where查询，直接读取对应文档性能更好，写法更简洁：

Future<void> getUserData() async {
  final DocumentSnapshot userDoc = await FirebaseFirestore.instance
      .collection('users')
      .doc(currentUser)
      .get();
  
  if (userDoc.exists) {
    final Map<String, dynamic> userData = userDoc.data() as Map<String, dynamic>;
    contacts = userData['contacts'] ?? [];
  }
}

内容的提问来源于stack exchange，提问作者Tom Schäfer