Flutter中用for循环填充List<String>问题：Firebase仅获一个文档ID

问题根源 #

你每次循环时用IDs = [itemIDs.id];直接覆盖了整个列表，而不是向列表中添加新元素，最终只会保留最后一次循环的文档ID。另外调用异步函数getDocs()时未加await，可能导致函数提前执行完毕，无法保证数据获取完成。

修复后的代码 #

Future saveUserCart(User currentUser) async {
  List<String> IDs = [];

  Future getDocs() async {
    QuerySnapshot querySnapshot = await FirebaseFirestore.instance
        .collection('users')
        .doc(currentUser.uid)
        .collection("userCart")
        .get();
    for (int i = 0; i < querySnapshot.docs.length; i++) {
      var itemIDs = querySnapshot.docs[i];
      print(itemIDs.id);
      // 使用add方法追加元素，而非覆盖整个列表
      IDs.add(itemIDs.id);
    }
    print(IDs);
  }
  await getDocs(); // 添加await确保异步操作完成
}

相关知识点解析 #

• Dart列表操作：
  • =赋值会直接替换整个列表对象，而add()方法才是向现有列表中追加单个元素；如果需要批量添加，可使用addAll()简化代码：

    IDs.addAll(querySnapshot.docs.map((doc) => doc.id));
    

  • 也可以用forEach进一步简化遍历逻辑：

    querySnapshot.docs.forEach((doc) => IDs.add(doc.id));
    

• 异步函数处理：调用返回Future的异步函数时，必须加await才能等待其执行完成，否则外层函数会跳过等待直接执行后续代码，导致数据未正确获取。
• Firebase Firestore文档ID获取：QuerySnapshot.docs返回所有匹配的文档列表，每个QueryDocumentSnapshot对象的id属性即为文档的唯一ID。

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