Flutter如何获取Firestore文档中List类型字段的长度？

首先需明确需求场景，以下分两种常见情况给出实现方案：

场景1：展示单个指定用户的群组列表 #

如果目标是展示某一特定用户的groups内容，需先定位到该用户文档，再获取groups字段的长度：

StreamBuilder<DocumentSnapshot>(
  stream: FirebaseFirestore.instance.collection("users").doc("目标用户ID").snapshots(),
  builder: (context, AsyncSnapshot<DocumentSnapshot> snapshot) {
    if (snapshot.hasData && snapshot.data!.exists) {
      Map<String, dynamic> userData = snapshot.data!.data() as Map<String, dynamic>;
      // 做空值兜底，避免字段不存在引发异常
      List<dynamic> groups = userData["groups"] ?? [];
      
      if (groups.isNotEmpty) {
        return ListView.builder(
          itemCount: groups.length,
          itemBuilder: ((context, index) {
            return Text(groups[index].toString());
          }),
        );
      } else {
        return const Center(child: Text("暂无群组"));
      }
    } else if (snapshot.hasError) {
      return Center(child: Text("加载出错：${snapshot.error}"));
    } else {
      return const Center(child: CircularProgressIndicator(color: Colors.red));
    }
  },
);

场景2：展示所有用户的群组合并列表 #

如果需要把所有用户的groups合并成一个列表展示，先计算所有groups的总长度：

StreamBuilder<QuerySnapshot>(
  stream: FirebaseFirestore.instance.collection("users").snapshots(),
  builder: (context, AsyncSnapshot<QuerySnapshot> snapshot) {
    if (snapshot.hasData) {
      List<dynamic> allGroups = [];
      // 遍历所有文档，收集非空的groups内容
      for (var doc in snapshot.data!.docs) {
        List<dynamic> groups = (doc.data() as Map<String, dynamic>)["groups"] ?? [];
        allGroups.addAll(groups);
      }
      
      if (allGroups.isNotEmpty) {
        return ListView.builder(
          itemCount: allGroups.length,
          itemBuilder: ((context, index) {
            return Text(allGroups[index].toString());
          }),
        );
      } else {
        return const Center(child: Text("暂无群组"));
      }
    } else if (snapshot.hasError) {
      return Center(child: Text("加载出错：${snapshot.error}"));
    } else {
      return const Center(child: CircularProgressIndicator(color: Colors.red));
    }
  },
);

针对你原有代码的修改 #

如果要在原有代码基础上，计算筛选后文档的groups总长度，可这样修改：

StreamBuilder<QuerySnapshot>(
  stream: FirebaseFirestore.instance.collection("users").snapshots(),
  builder: (context, AsyncSnapshot<QuerySnapshot> snapshot) {
    if (snapshot.hasData) {
      final docsWithGroups = snapshot.data!.docs.where(
          (doc) => ((doc.data() as Map<String, dynamic>)["groups"] as List?)?.isNotEmpty ?? false);
      
      int totalGroupsLength = 0;
      for (var doc in docsWithGroups) {
        List<dynamic> groups = (doc.data() as Map<String, dynamic>)["groups"] ?? [];
        totalGroupsLength += groups.length;
      }
      
      if (totalGroupsLength > 0) {
        return ListView.builder(
          itemCount: totalGroupsLength,
          itemBuilder: ((context, index) {
            return Text("data");
          }),
        );
      } else {
        return const Center(child: Text("No posts"));
      }
    } else {
      return const Center(child: CircularProgressIndicator(color: Colors.red));
    }
  },
);

注意：必须添加空值判断逻辑，避免groups字段不存在或为空时触发空指针异常。

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