Flutter Firebase：如何让当前用户仅访问自身子集合数据？

核心问题诊断 #

你当前的代码存在三个关键问题：

• 使用collectionGroup会拉取所有文档下的Requests子集合，无法实现用户数据隔离
• 未处理StreamBuilder的快照状态（加载中、错误、无数据），导致空白页或崩溃
• 错误地将QuerySnapshot类型强制转换为Map，引发类型不匹配的红屏报错

解决方案 #

1. 配置Firestore安全规则（必做） #

首先必须通过安全规则限制用户仅能访问自己的数据，防止越权访问：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /ADS/{userId}/Requests/{requestId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

2. 正确的列表展示实现 #

修改StreamBuilder代码，完善状态处理逻辑，避免空指针和空白页：

Stream<QuerySnapshot<Map<String, dynamic>>> myRide = FirebaseFirestore
    .instance
    .collection('ADS')
    .doc(FirebaseAuth.instance.currentUser?.uid) // 用可选链避免未登录崩溃
    .collection('Requests')
    .snapshots();

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
      stream: myRide,
      builder: (context, snapshot) {
        // 加载中状态
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        }

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

        // 无数据状态
        if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
          return const Center(child: Text('暂无请求记录'));
        }

        // 正常渲染列表
        final requestDocs = snapshot.data!.docs;
        return ListView.builder(
          itemCount: requestDocs.length,
          itemBuilder: (context, index) {
            final requestData = requestDocs[index].data();
            return Card(
              child: ListTile(
                onTap: () {},
                title: Text(requestData['Name'] ?? '未知名称'), // 空值兜底
              ),
            );
          },
        );
      },
    ),
  );
}

3. 单条数据展示的正确写法 #

如果只需展示单个请求文档，需指定具体文档ID：

Stream<DocumentSnapshot<Map<String, dynamic>>> myRide = FirebaseFirestore
    .instance
    .collection('ADS')
    .doc(FirebaseAuth.instance.currentUser?.uid)
    .collection('Requests')
    .doc('your-specific-document-id') // 替换为实际文档ID
    .snapshots();

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: StreamBuilder<DocumentSnapshot<Map<String, dynamic>>>(
      stream: myRide,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        }
        if (snapshot.hasError) {
          return Center(child: Text('加载失败: ${snapshot.error}'));
        }
        if (!snapshot.hasData || !snapshot.data!.exists) {
          return const Center(child: Text('无数据'));
        }

        final data = snapshot.data!.data()!;
        return Center(child: Text(data['Driver Name'] ?? '未知司机'));
      },
    ),
  );
}

关键修正点说明 #

• 避免强制解包：用currentUser?.uid替代currentUser!.uid，防止用户未登录时触发空指针
• 状态全覆盖：必须处理加载中、错误、无数据三种边缘情况，这是解决空白页的核心
• 正确获取数据：QuerySnapshot是文档集合，需通过docs[index].data()获取单条文档数据，不能直接将整个QuerySnapshot转为Map

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