如何在Flutter中从Firebase Firestore文档子集合获取用户专属数据

核心思路 #

用户登录后，通过Firebase Auth拿到当前用户的uid，以此作为路径定位到该用户对应的专属子集合，查询数据后在界面展示即可。

代码实现 #

1. 获取当前用户ID #

先确认用户已完成登录，拿到唯一标识uid：

import 'package:firebase_auth/firebase_auth.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

final currentUser = FirebaseAuth.instance.currentUser;
if (currentUser == null) {
  // 用户未登录，可跳转登录页或给出提示
  return;
}
final userId = currentUser.uid;

2. 查询用户专属子集合数据 #

假设你的Firestore结构是users/{userId}/[你的子集合名称]，对应截图里的层级，查询代码如下：

// 替换成你实际的子集合名称，比如tasks、notes等
final userSubCollection = FirebaseFirestore.instance
    .collection('users')
    .doc(userId)
    .collection('yourSubcollectionName');

// 实时监听数据变化（如果只需要单次获取，改用get()方法）
Stream<QuerySnapshot> userDataStream = userSubCollection.snapshots();

3. 用StreamBuilder展示数据 #

在Widget中通过StreamBuilder实时渲染数据列表：

StreamBuilder<QuerySnapshot>(
  stream: userDataStream,
  builder: (context, snapshot) {
    if (snapshot.hasError) {
      return Text('加载失败: ${snapshot.error}');
    }

    if (snapshot.connectionState == ConnectionState.waiting) {
      return const CircularProgressIndicator();
    }

    final dataDocs = snapshot.data!.docs;
    return ListView.builder(
      itemCount: dataDocs.length,
      itemBuilder: (context, index) {
        final itemData = dataDocs[index].data() as Map<String, dynamic>;
        // 根据你实际的字段名替换，比如itemData['name']、itemData['content']
        return ListTile(
          title: Text(itemData['title'] ?? '无标题'),
          subtitle: Text(itemData['description'] ?? '无描述'),
        );
      },
    );
  },
);

关键注意事项 #

• 必须配置正确的Firestore安全规则，确保用户只能访问自己的子集合：

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

• 如果不需要实时更新数据，可将snapshots()替换为get()，同时用FutureBuilder替代StreamBuilder。

内容的提问来源于stack exchange，提问作者V.Amsiha