Flutter中Firestore嵌套集合无法获取数据的问题排查

在Flutter应用中使用Firestore嵌套集合获取数据时遇到空结果问题，具体情况如下：

• 数据结构：users/{userId}/tests/{testType}/test_set/{testSetId}
• 目标：获取特定testType下test_set集合内的所有文档
• 现象：查询返回空结果，但Firestore后台确实存在对应数据
• 已配置的Firestore安全规则：

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

• 当前使用的Flutter代码：

Future<List<Map<String, dynamic>>> _fetchTestResults() async {
    final user = FirebaseAuth.instance.currentUser;
    if (user == null) return [];

    print("UUID = " + user.uid);

    // Build the reference step by step and print debug information
    final usersRef = FirebaseFirestore.instance.collection('users');
    print('Users reference path: ${usersRef.path}');

    final userDocRef = usersRef.doc(user.uid);
    print('User document reference path: ${userDocRef.path}');

    final testsCollectionRef = userDocRef.collection('/tests/');
    print('Tests collection reference path: ${testsCollectionRef.path}');

    // final testResultsRef =
    //     testsCollectionRef.doc(testType).collection('test_set');
    // print('Test results reference path: ${testResultsRef.path}');

    // Fetch data
    final snapshot = await testsCollectionRef.get();
    print('Snapshot: ${snapshot.docs.length} documents');

    if (snapshot.docs.isEmpty) {
      print("Snapshot empty");
      return [];
    }

    return snapshot.docs.map((doc) {
      final data = doc.data();
      print('Document ID: ${doc.id}, Data: $data');
      return {
        'test_id': doc.id,
        'data': data,
        'timestamp': data['timestamp'] as Timestamp,
        'correct_answers': data['correct_answers'] as int,
      };
    }).toList();
  }

• 日志显示：testsCollectionRef.get()返回0个文档，但usersRef.get()能正常获取到数据

核心问题1：集合路径写法错误 #

你在创建testsCollectionRef时用了userDocRef.collection('/tests/')，路径开头的斜杠会让Firestore把它解析成根路径下的tests集合，而不是当前用户文档下的嵌套集合，自然查不到数据。

修复方式： #

去掉路径开头的斜杠，改成：

final testsCollectionRef = userDocRef.collection('tests');

核心问题2：未访问到目标集合 #

当前代码只查询了tests集合的文档，但你的目标是tests/{testType}/test_set下的文档，需要补全完整路径层级。

修复后的完整查询代码： #

Future<List<Map<String, dynamic>>> _fetchTestResults(String testType) async {
    final user = FirebaseAuth.instance.currentUser;
    if (user == null) return [];

    print("UUID = " + user.uid);

    // 正确构建嵌套集合路径
    final testSetRef = FirebaseFirestore.instance
        .collection('users')
        .doc(user.uid)
        .collection('tests')
        .doc(testType)
        .collection('test_set');

    print('Test set reference path: ${testSetRef.path}');

    // 获取目标集合数据
    final snapshot = await testSetRef.get();
    print('Snapshot: ${snapshot.docs.length} documents');

    if (snapshot.docs.isEmpty) {
      print("Snapshot empty");
      return [];
    }

    return snapshot.docs.map((doc) {
      final data = doc.data();
      print('Document ID: ${doc.id}, Data: $data');
      return {
        'test_id': doc.id,
        'data': data,
        'timestamp': data['timestamp'] as Timestamp,
        'correct_answers': data['correct_answers'] as int,
      };
    }).toList();
  }

额外验证步骤 #

1. 打印最终的testSetRef.path，确认路径格式为users/{userId}/tests/{testType}/test_set，和Firestore后台的路径完全匹配
2. 检查Firestore后台中tests集合下是否存在对应testType的文档，且该文档下的test_set集合有数据
3. 确认当前登录用户的uid和Firestore中users集合下的文档ID完全一致（注意大小写、特殊字符）

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