Flutter中读取Cloud Firestore顶层集合并实现ListView展示

步骤1：获取顶层集合列表 #

Firebase Firestore提供了listCollections()方法，用于获取当前数据库的顶层集合引用列表。这是一个异步方法，返回Future<List<CollectionReference>>。

步骤2：用FutureBuilder处理异步数据 #

使用FutureBuilder监听集合列表的加载状态，根据不同状态构建对应UI：加载中显示进度指示器，加载完成后渲染ListView展示集合。

完整代码示例 #

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class CollectionListScreen extends StatelessWidget {
  // 获取顶层集合的异步方法
  Future<List<CollectionReference>> _getTopLevelCollections() async {
    try {
      return await FirebaseFirestore.instance.listCollections();
    } catch (e) {
      print('获取集合失败: $e');
      return [];
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Firestore顶层集合')),
      body: FutureBuilder<List<CollectionReference>>(
        future: _getTopLevelCollections(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }

          if (snapshot.hasError) {
            return Center(child: Text('加载失败: ${snapshot.error}'));
          }

          final collections = snapshot.data ?? [];
          if (collections.isEmpty) {
            return const Center(child: Text('无顶层集合'));
          }

          return ListView.builder(
            itemCount: collections.length,
            itemBuilder: (context, index) {
              final collection = collections[index];
              return ListTile(
                title: Text(collection.id),
                onTap: () {
                  print('点击了集合: ${collection.id}');
                },
              );
            },
          );
        },
      ),
    );
  }
}

注意事项 #

• 权限配置：确保Firestore安全规则允许读取顶层集合。测试阶段可临时设置：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if true;
      }
    }
  }
  

  生产环境必须替换为符合业务需求的权限规则，避免数据泄露。
• 异常处理：代码中加入了基础异常捕获，实际开发中可根据需求展示更友好的错误提示。

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