Flutter对接Firestore无法打印子集合文档字段，.doc()参数应如何填写？

核心结论 #

.doc()括号中需要填写对应用户的UID（用户唯一标识），你的数据结构中users集合下的每一条文档对应一个独立用户，Weightlifting是隶属于单个用户的子集合，必须指定父用户文档的ID才能正确访问子集合内容。

正确代码实现 #

1. 访问当前登录用户的子集合 #

// 引入Firebase Auth包后获取当前登录用户
final User? currentUser = FirebaseAuth.instance.currentUser;
// 组装子集合引用
final CollectionReference wLCollection = FirebaseFirestore.instance
    .collection('users')
    .doc(currentUser?.uid) // 此处传入用户UID
    .collection('Weightlifting');

2. 打印子集合所有文档字段示例 #

// 监听数据流打印内容
WLlogs.listen((logList) {
  for (var log in logList) {
    if (log == null) continue;
    print('===== 举重日志 =====');
    print('日期：${log.date}');
    print('硬拉：${log.deadLiftWeight}kg * ${log.deadLiftReps}次');
    print('深蹲：${log.backSquatWeight}kg * ${log.backSquatReps}次');
    // 其余字段按需添加打印即可
  }
});

3. 特殊场景：查询所有用户的Weightlifting子集合 #

如果需要跨用户查询所有Weightlifting子集合的文档，使用集合组查询即可，无需指定用户文档ID：

final Query wLGroupQuery = FirebaseFirestore.instance.collectionGroup('Weightlifting');

// 对应stream修改为
Stream<List<WeightliftingLogs?>> get WLlogs {
  return wLGroupQuery.snapshots().map(_WLlistFromSnapshot);
}

注意事项 #

• 访问单用户子集合前必须确认用户已完成Firebase Auth登录，否则currentUser为null会导致路径错误
• 需要提前配置Firebase安全规则，放开对应路径的读权限，否则会触发权限拒绝报错
• 使用集合组查询前，需要在安全规则中单独配置集合组的读权限，否则无法正常拉取数据

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