Firebase Cloud Firestore：为所有用户UID在userinfo集合创建对应文档

要给现有大量用户批量创建userinfo集合的文档，只能通过Firebase Admin SDK实现——客户端SDK没有权限获取全量用户列表，只有Admin SDK能调用用户管理API拿到所有用户UID。下面是具体实现步骤：

1. 准备工作 #

• 从Firebase控制台下载服务账号密钥（项目设置→服务账号→生成新的私钥）
• 本地或服务器环境安装Node.js，然后执行：

  npm install firebase-admin
  

2. 编写批量处理脚本 #

创建一个batch-create-userinfo.js文件，代码如下：

const admin = require('firebase-admin');
const serviceAccount = require('./path/to/your/service-account-key.json');

// 初始化Admin SDK
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount)
});

const firestore = admin.firestore();
const batchSize = 500; // 每批次写入的文档数，避免超限
let processedUsers = 0;

async function processAllUsers() {
  let nextPageToken = null;
  do {
    // 分页获取用户列表，每次最多拉1000个
    const listUsersResult = await admin.auth().listUsers(1000, nextPageToken);
    const userUIDs = listUsersResult.users.map(user => user.uid);
    
    // 批量写入Firestore
    let batch = firestore.batch();
    userUIDs.forEach(uid => {
      const docRef = firestore.collection('userinfo').doc(uid);
      // 这里可以设置初始字段，比如徽章初始值、创建时间等
      batch.set(docRef, {
        badges: [],
        createdAt: admin.firestore.FieldValue.serverTimestamp()
      }, { merge: true }); // 用merge避免覆盖已存在的文档
      
      processedUsers++;
      // 达到批次大小就提交
      if (processedUsers % batchSize === 0) {
        batch.commit();
        batch = firestore.batch();
        console.log(`已处理 ${processedUsers} 个用户`);
      }
    });
    
    // 提交剩余的批量操作
    if (userUIDs.length > 0 && processedUsers % batchSize !== 0) {
      await batch.commit();
      console.log(`已处理 ${processedUsers} 个用户`);
    }
    
    nextPageToken = listUsersResult.pageToken;
  } while (nextPageToken);
  
  console.log(`全部处理完成，共创建 ${processedUsers} 个userinfo文档`);
}

// 执行脚本
processAllUsers().catch(error => {
  console.error('处理过程出错：', error);
  process.exit(1);
});

3. 运行脚本 #

在终端执行：

node batch-create-userinfo.js

注意事项 #

• 确保服务账号拥有Cloud Firestore 写入权限和用户管理权限（在IAM控制台配置）
• 如果用户量超过10万，建议分多次运行脚本，或在Cloud Functions中使用定时任务执行（避免超时）
• 脚本中的merge: true参数可以保留已存在的userinfo文档，不会覆盖，适合后续补漏
• 可以添加错误捕获，记录创建失败的UID，方便后续重试

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