Flutter 中如何为 Firebase 每个用户文档添加不同数据子集合

问题根因 #

不同用户子集合数据完全一致的问题，90%以上的场景属于以下两种错误：

• 遍历LoanFriends集合生成子集合数据时，把子集合数据的生成逻辑写在了循环外部，全局复用了同一个数据对象
• 子集合数据未和当前遍历到的用户文档的唯一标识（uid/文档ID）做关联，所有用户写入的都是静态固定数据

正确实现代码示例 #

1. 新增用户时同步创建专属子集合 #

如果是给新注册的用户自动生成子集合，直接在创建用户文档的逻辑后追加子集合写入逻辑即可：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> createUserWithCustomSubcollection(Map<String, dynamic> userData) async {
  final firestore = FirebaseFirestore.instance;
  // 1. 先创建用户主文档
  final userDocRef = await firestore.collection('LoanFriends').add(userData);
  final userId = userDocRef.id; // 获取新创建的用户文档唯一ID

  // 2. 为当前用户生成专属的子集合数据，逻辑写在当前作用域内，不要全局复用
  // 示例：生成和用户ID关联的专属子集合数据，你可以替换为自己的业务生成逻辑
  final userExclusiveSubcollectionData = [
    {
      'recordId': '${userId}_record_1',
      'createTime': Timestamp.now(),
      'belongUserId': userId,
      // 其他自定义业务字段
    },
    {
      'recordId': '${userId}_record_2',
      'createTime': Timestamp.now(),
      'belongUserId': userId,
      // 其他自定义业务字段
    }
  ];

  // 3. 写入当前用户专属的子集合，子集合名可以自定义，比如叫userRecords
  final subcollectionRef = userDocRef.collection('userRecords');
  for (var record in userExclusiveSubcollectionData) {
    await subcollectionRef.add(record);
  }
}

2. 批量给已有用户补全子集合 #

如果是给已经存在的LoanFriends集合内的所有用户批量补子集合，必须把每个用户的子集合数据生成逻辑放在遍历循环内部：

Future<void> batchAddSubcollectionForExistUsers() async {
  final firestore = FirebaseFirestore.instance;
  // 1. 拉取所有已有用户文档
  final userListSnapshot = await firestore.collection('LoanFriends').get();

  // 2. 遍历每个用户文档
  for (var userDoc in userListSnapshot.docs) {
    final userId = userDoc.id;
    // *重点：子集合数据生成逻辑必须写在循环内部，每个用户单独生成一次
    final userExclusiveData = _generateCustomDataForUser(userId);

    // 写入当前用户的子集合
    final subcollectionRef = userDoc.reference.collection('userRecords');
    for (var record in userExclusiveData) {
      await subcollectionRef.add(record);
    }
  }
}

// 自定义生成每个用户专属数据的方法，入参关联用户唯一标识
List<Map<String, dynamic>> _generateCustomDataForUser(String userId) {
  // 在这里写你的业务逻辑，生成每个用户不一样的子集合数据
  return [
    {
      'belongUserId': userId,
      'initAmount': userId.hashCode % 10000, // 示例：用用户ID哈希生成差异化数值
      'createTime': Timestamp.now(),
    }
  ];
}

验证排查点 #

如果修改后还是有问题，按以下顺序排查：

• 确认_generateCustomDataForUser方法每次传入不同用户ID时，返回的列表数据不同
• 确认没有在循环外部提前定义好子集合数据列表，循环时直接复用同一个列表
• 确认写入子集合时，用的是当前遍历到的单个用户文档的collection方法，而不是全局固定的集合引用

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