Flutter中Firestore QuerySnapshot调用await不生效问题及优化咨询

1. await不生效的核心原因 #

你遇到的await未等待执行的问题是Dart的经典异步陷阱：forEach方法不会等待内部传入的async回调执行完成，所有内部异步操作返回的Future都没有被外层函数追踪，所以doItAll方法会在Firestore请求还没返回时就直接return。

2. 修复后的代码 #

这里直接替换嵌套forEach为普通for循环，同时用Future.wait优化批量请求，避免逐个发送请求降低效率：

Future<List<User>> doItAll() async {
  List<User> currentUserContacts = [];
  // 提前清空避免上次残留数据
  _currentUserContacts.clear();
  if (await FlutterContacts.requestPermission()) {
    _phoneContacts = await FlutterContacts.getContacts(withProperties: true);
  }
  if (_phoneContacts.isEmpty) return currentUserContacts;

  var fireStore = FirebaseFirestore.instance.collection('users');
  // 先收集所有规范化手机号，避免重复查询
  Set<String> allPhones = {};
  // 同时存手机号对应的联系人姓名方便后续赋值
  Map<String, String> phoneToName = {};

  for (var contact in _phoneContacts) {
    for (var phone in contact.phones) {
      String normalizedPhone = phone.normalizedNumber;
      allPhones.add(normalizedPhone);
      phoneToName[normalizedPhone] = contact.displayName;
    }
  }

  // Firestore的whereIn单次最多支持10个参数，分批查询
  List<List<String>> phoneBatches = [];
  for (int i = 0; i < allPhones.length; i += 10) {
    int end = (i + 10 < allPhones.length) ? i + 10 : allPhones.length;
    phoneBatches.add(allPhones.sublist(i, end).toList());
  }

  // 批量执行所有批次的查询
  await Future.wait(phoneBatches.map((batch) async {
    var query = fireStore.where('phoneNumber', whereIn: batch);
    var res = await query.get();
    for (var doc in res.docs) {
      String phone = doc.data()['phoneNumber'];
      currentUserContacts.add(User(
        phoneNumber: phone,
        userId: doc.id,
        displayName: phoneToName[phone] ?? '',
      ));
    }
  }));

  _currentUserContacts = currentUserContacts;
  return List.from(currentUserContacts);
}

3. 断点无法继续问题排查 #

• 优先升级flutter_contacts插件到最新版本，部分旧版本在安卓模拟器上会出现异步调用卡调试的问题
• 替换模拟器为真机测试，你控制台打印的W/ProviderInstaller类警告是模拟器常见问题，会干扰调试链路
• 勾选IDE的「异步调试」选项，Dart的异步断点默认需要开启对应配置才能正常步进

4. 优化点说明 #

• 用Set收集手机号自动去重，同一个手机号不会重复查询
• 批量查询代替单条查询，请求数从N个降到N/10个，大幅提升查询效率，同时降低Firestore的调用成本
• 避免用全局变量临时存结果，方法内部维护临时列表避免并发调用时的数据污染

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