Flutter场景下如何为Firestore所有已认证用户添加公共全局数据

首先优先推荐无冗余的公共集合方案，仅当业务必须要求公共数据下沉到用户专属文档时再选择批量同步方案：

方案1：独立公共集合存储（最优） #

• 直接在Firestore根目录创建名为global_public_data的顶级集合，所有全局公共数据统一存在该集合下，无需向每个用户的专属文档同步。
• 配置Firestore安全规则，开放该集合的读权限给所有已认证用户，写权限仅开放给管理员，规则参考：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 公共数据规则
    match /global_public_data/{docId} {
      allow read: if request.auth != null;
      allow write: if request.auth.token.is_admin == true;
    }
    // 其余原有规则保留
  }
}

• 优势：完全不需要处理新老用户的同步逻辑，公共数据仅需更新一次，所有用户即时获取最新版本，无存储冗余，维护成本极低。

方案2：自动同步到用户专属文档（适用于特殊业务场景） #

如果你的业务要求用户可以基于公共数据做个性化修改，必须将公共数据存入每个用户的专属文档，可通过Firebase Admin SDK结合云函数实现全自动化同步：

新用户自动同步 #

• 部署functions.auth.user().onCreate云函数触发器，新用户注册完成后自动触发云函数，将最新的全局公共数据写入该用户的专属文档，完全不需要客户端参与同步逻辑。

老用户批量同步 #

• 运行一次性Admin SDK脚本，批量拉取所有已注册用户的uid，批量写入公共数据到对应文档，参考代码（Node.js环境）：

const admin = require('firebase-admin');
// 导入你项目的服务账号密钥初始化Admin SDK
const serviceAccount = require('./service-account-key.json');
admin.initializeApp({ credential: admin.credential.cert(serviceAccount) });

// 全局公共数据内容
const GLOBAL_PUBLIC_DATA = {
  // 替换为你的实际公共数据
  publicList: [],
  updateTime: admin.firestore.FieldValue.serverTimestamp()
};

async function batchSyncPublicData() {
  let pageToken;
  // 分页拉取用户避免大数据量内存溢出
  do {
    const userPage = await admin.auth().listUsers(1000, pageToken);
    const batch = admin.firestore().batch();
    userPage.users.forEach(user => {
      const userDocRef = admin.firestore().doc(`users/${user.uid}`);
      // merge: true 避免覆盖用户已有的私人数据
      batch.set(userDocRef, { publicData: GLOBAL_PUBLIC_DATA }, { merge: true });
    });
    await batch.commit();
    pageToken = userPage.pageToken;
  } while (pageToken);
  console.log('所有用户公共数据同步完成');
}

batchSyncPublicData().catch(console.error);

• 后续公共数据更新时，重新运行一次上述脚本即可完成全量用户的公共数据更新，无需手动操作。

你之前提到的无法提前获取用户uid的问题，通过Admin SDK直接拉取全量认证用户列表即可解决，不需要提前收集uid也不需要在网页后台手动操作。

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