如何使用Firebase Node Admin SDK按创建时间列出用户（超百万用户）

可行方案说明 #

由于Firebase Admin SDK的listUsers接口不支持直接按创建时间排序，结合你的百万级用户规模，推荐以下几种高效实现方式：

1. 同步创建时间到数据库并建立索引（推荐）

• 初始化同步：编写批量脚本，将所有用户的metadata.creationTime同步到Firestore或Realtime Database的用户元数据集合中，为creationTime字段创建索引。
• 分页查询：通过数据库的分页排序能力（如Firestore的orderBy('creationTime').limit(1000).startAfter(lastCreationTime)）获取按创建时间排序的UID列表，再调用admin.auth().getUsers(uidList)批量获取完整用户信息。
• 增量维护：通过Cloud Functions监听user.create事件，实时将新用户的创建时间同步到数据库，确保数据实时性。

批量同步脚本示例：

const admin = require('firebase-admin');
admin.initializeApp();

async function syncAllUserCreationTime() {
  let pageToken = null;
  do {
    const { users, pageToken: nextPageToken } = await admin.auth().listUsers(1000, pageToken);
    const batch = admin.firestore().batch();
    
    users.forEach(user => {
      const metaRef = admin.firestore().collection('user_auth_meta').doc(user.uid);
      batch.set(metaRef, {
        creationTime: user.metadata.creationTime,
        uid: user.uid
      }, { merge: true });
    });
    
    await batch.commit();
    pageToken = nextPageToken;
  } while (pageToken);
}

// 执行同步
syncAllUserCreationTime().catch(console.error);

2. 利用Cloud Audit Logs筛选创建事件

如果项目启用了Cloud Audit Logs，可以通过Cloud Logging API筛选google.firebase.auth.user.create类型的日志，按时间戳排序后提取用户UID，再批量获取用户信息。注意审计日志有保留期限，需确认是否覆盖所有历史用户的创建记录。

3. 分页遍历+内存排序（仅临时应急）

如果以上方案暂无法实施，可每次分页拉取1000条用户数据，在内存中按metadata.creationTime排序后返回，但百万级数据会导致多次API调用和内存压力，不推荐长期使用。

关键优化点 #

• 使用getUsers批量获取用户，减少单条getUser的API调用次数。
• 数据库分页查询时，利用游标（startAfter）实现高效的续页逻辑，避免重复数据。

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