Flutter/Dart中通过文档ID数组高效查询Firebase数据的方法

我现在通过循环遍历文档ID数组，从Firebase的users集合中逐个获取用户数据，代码如下。但成员列表最多可能有10000个用户，这样发起10000次请求的效率实在太低了，想问问有没有更高效的批量查询方式？

ref = db.collection('users');
Future<List<User>> fetchAllMembers({List<dynamic> members}) async {
  List<User> results = [];
  for (String userID in members) {
    await ref.document(userID).get().then((result) {
      results.add(User.fromMap(result.data, result.documentID));
    });
  }
  return results;
}

当然有更高效的方式！Firebase Firestore提供了whereIn查询，可以一次性批量获取多个指定ID的文档，这能大幅减少网络请求次数，直接提升效率。

不过要注意一个关键限制：每个whereIn查询最多支持传入50个文档ID（这是Firestore官方的查询限制）。所以如果你的成员列表超过50个，需要把ID数组拆分成多个不超过50个元素的子数组，分批发起查询后再合并结果。

下面是优化后的完整代码：

ref = db.collection('users');
Future<List<User>> fetchAllMembers({List<dynamic> members}) async {
  List<User> results = [];
  // 将ID数组按每50个一组拆分
  List<List<String>> batches = [];
  for (int i = 0; i < members.length; i += 50) {
    int endIndex = i + 50;
    batches.add(
      members.sublist(i, endIndex > members.length ? members.length : endIndex).cast<String>()
    );
  }

  // 分批发起批量查询
  for (var batch in batches) {
    QuerySnapshot querySnapshot = await ref.where(FieldPath.documentId, whereIn: batch).get();
    // 遍历查询结果并转换为User对象
    querySnapshot.docs.forEach((doc) {
      results.add(User.fromMap(doc.data() as Map<String, dynamic>, doc.id));
    });
  }

  return results;
}

优化点说明 #

• 请求次数大幅减少：原来的代码需要发起10000次独立请求，优化后仅需200次（10000/50），直接砍掉了大量网络握手和请求延迟的开销。
• 逻辑更简洁：用批量查询替代循环单查，代码结构更清晰，维护成本更低。

额外提醒：如果你的members数组里存在重复ID，whereIn查询只会返回对应文档一次。如果业务需要保留重复项的话，你得在合并结果时额外处理重复ID的映射关系。

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