Flutter Dart中forEach行为异常：列表长度输出不符预期

问题根源 #

你用了FirebaseFirestore的snapshots()方法，它返回的是Stream类型，用来监听集合的实时变化。chatsRef.forEach()是异步订阅Stream的操作，不会阻塞后续代码执行。函数的执行流程是：

1. 初始化空列表vList
2. 创建Stream对象chatsRef
3. 调用forEach订阅Stream，但这个操作是异步的，不会等回调执行完
4. 直接执行print("Final : $i")，此时vList还是空的，所以输出0
5. 之后Stream收到Firestore的数据，执行forEach的回调，填充vList并打印Inside loop count : 4

核心就是：同步代码先执行，Stream的异步回调后执行，导致Final的打印先出结果，此时数据还没加载完成。

解决方案 #

根据你的需求分两种情况处理：

情况1：只需要获取一次数据（不需要实时监听） #

如果只是一次性获取历史聊天记录，不需要监听后续变化，用get()方法代替snapshots()更合适，它返回Future<QuerySnapshot>，可以用await等待数据返回：

Future<List<CustomListItems>> getPrevChats() async {
  List<CustomListItems> vList = [];

  final QuerySnapshot<Map<String, dynamic>> snapshot =
      await FirebaseFirestore.instance.collection("AT").get();

  for (var doc in snapshot.docs) {
    vList.add(CustomListItems(doc.data()['message'], doc.data()['author']));
  }
  
  int i = vList.length;
  print("Final : $i"); // 此时会输出4
  return vList;
}

情况2：需要实时监听集合变化 #

如果确实需要实时监听数据更新，要用await for遍历Stream，确保等待到数据后再执行后续代码（如果要持续监听，就去掉break，但这种场景通常不会直接返回列表，而是配合StreamBuilder在UI层处理）：

Future<List<CustomListItems>> getPrevChats() async {
  List<CustomListItems> vList = [];

  final Stream<QuerySnapshot<Map<String, dynamic>>> chatsRef =
      FirebaseFirestore.instance.collection("AT").snapshots();

  // 等待Stream的第一个事件，后续事件还会触发，只取第一次就加break
  await for (var data in chatsRef) {
    vList.clear(); // 避免重复添加数据
    for (var doc in data.docs) {
      vList.add(CustomListItems(doc.data()['message'], doc.data()['author']));
    }
    int i = vList.length;
    print("Inside loop count : $i");
    break;
  }
  
  int i = vList.length;
  print("Final : $i"); // 此时会输出4
  return vList;
}

补充说明 #

• snapshots()适合需要实时更新UI的场景（比如用StreamBuilder监听数据变化自动刷新UI），一次性获取数据用get()更高效。
• 异步操作中，必须确保等待异步任务完成后再处理结果，避免出现数据未加载就执行后续代码的问题。

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