Flutter/Dart中return为何不等待嵌套then执行完成？

一、核心问题：为什么第一段代码的await没有等待嵌套异步操作？ #

第一段代码的问题在于await仅等待了最外层的Firestore查询（.get()）完成，但嵌套在.then()和.forEach()里的document.reference.parent.parent!.get().then(...)是独立的异步操作，并没有被await。

当外层的await执行完成后，代码直接走到return myChatterIDs，此时那些嵌套的then回调还没触发，所以返回的是空列表。你添加的Future.delayed只是靠延迟强行等待异步操作完成，属于不可靠的临时写法。

第二段代码能正常工作的原因：

• 用await直接获取外层查询结果，避免了.then()的嵌套回调，逻辑更清晰
• 在循环中对每个文档的父查询、审批查询都用了await，确保每一步异步操作完成后再继续执行，因此列表能被正确填充

二、公开/需审批群组会员身份的实践建议 #

1. 数据结构优化 #

• 减少嵌套查询：可以在members-chatter的文档中直接存储对应chatter的public状态，以及用户的approved状态（非公开群组场景），这样一次集合组查询就能拿到所有必要信息，无需额外查询父文档和审批集合
• 维护用户侧缓存列表：在用户的Firestore文档里维护joinedChatters数组，存储用户已加入的（公开+已审批）chatter ID，查询时直接读取用户文档即可，大幅提升性能

2. 安全规则配置 #

• 公开群组：允许任何用户读取chatter数据，但仅允许群组成员修改成员集合、发送消息等操作
• 非公开群组：仅允许approved-chatter集合中的用户读取chatter数据，审批操作仅限群组管理员执行
• 成员集合权限：限制只有用户本人或管理员能修改members-chatter中的status字段，防止恶意篡改

3. 隐私与性能平衡 #

• 通过Firestore安全规则严格拦截未授权查询，确保未审批用户无法获取非公开群组的任何信息
• 对高频访问的chatter数据做本地缓存（如Hive、SharedPreferences），减少Firestore读写次数，降低加载延迟

第一段（存在问题的代码） #

// 获取我的chatter ID列表
Future<List<String>> oldgetMyChatterIDs() async {
  List<String> myChatterIDs = [];

  await FirebaseFirestore.instance
      .collectionGroup('members-chatter')
      .where('uid', isEqualTo: FirebaseAuth.instance.currentUser?.uid)
      .where('status', isEqualTo: 'joined')
      .orderBy('timeLastActive', descending: true)
      .get()
      .then(
        (snapshot) => snapshot.docs.forEach((document) {
           document.reference.parent.parent!.get().then((value) { 
           // 这里的then没有被await
            if (value.data()?['public'] ?? true) {
              myChatterIDs.add(document.reference.parent.parent!.id);
              // return时这行代码还未执行，因此列表为空
            } else {
              // 检查用户是否已审批
            }
          });
        }),
      );

  // 加下面的延迟能让代码"工作"，但这不是正确的解决方式
  // await Future.delayed(const Duration(seconds: 1));

  return myChatterIDs;
}

第二段（正确工作的代码） #

// 获取我的chatter ID列表
Future<List<String>> getMyChatterIDs() async {
  List<String> myChatterIDs = [];

  QuerySnapshot<Map<String, dynamic>> joinedChattersSnapshot = await FirebaseFirestore
      .instance
      .collectionGroup('members-chatter')
      .where('uid', isEqualTo: FirebaseAuth.instance.currentUser?.uid)
      .where('status', isEqualTo: 'joined')
      .orderBy('timeLastActive', descending: true)
      .get();

  for (var i = 0; i < joinedChattersSnapshot.docs.length; i++) {
    DocumentSnapshot<Map<String, dynamic>> aChatDoc =
        await joinedChattersSnapshot.docs[i].reference.parent.parent!.get();
    bool isPublic = aChatDoc.data()?['public'] ?? true;
    if (isPublic) {
      myChatterIDs.add(aChatDoc.id);
    } else {
      try {
        DocumentSnapshot<Map<String, dynamic>> anApprovalDoc =
            await FirebaseFirestore.instance
                .collection('chatters')
                .doc(aChatDoc.id)
                .collection('approved-chatter')
                .doc(FirebaseAuth.instance.currentUser!.uid)
                .get();
        bool isApproved = anApprovalDoc.data()!['approved'];
        if (isApproved) {
          myChatterIDs.add(aChatDoc.id);
        }
      } catch (e) {
        // 可以把pending状态的chatter加入另一个列表
        // myPendingChatterIDs.add(aChatDoc.id);
      }
    }
  }

  return myChatterIDs;
}

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