Firebase Auth getUser为何不支持筛选？如何实现邮箱后缀查询用户？

Firebase Admin SDK的getUser()方法仅支持通过UID精准查询单个用户，无法直接执行模糊匹配筛选。要找出UID包含"@hayan.com"的用户，可采用以下两种可行方案：

方案一：通过listUsers()遍历并过滤 #

利用Admin SDK提供的listUsers()批量拉取用户列表（支持分页），在遍历过程中筛选符合条件的用户。示例代码：

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

async function filterUsersByUidPattern() {
  let pageToken = null;
  const matchedUsers = [];
  const targetPattern = "@hayan.com";

  do {
    // 每次最多拉取1000条用户数据
    const listUsersResult = await admin.auth().listUsers(1000, pageToken);
    // 过滤出UID包含目标字符串的用户
    const batchMatches = listUsersResult.users.filter(user => user.uid.includes(targetPattern));
    matchedUsers.push(...batchMatches);
    
    pageToken = listUsersResult.pageToken;
  } while (pageToken); // 分页遍历直到所有用户处理完成

  console.log(`找到符合条件的用户共${matchedUsers.length}个:`);
  matchedUsers.forEach(user => console.log(user.uid, user.email));
}

filterUsersByUidPattern().catch(console.error);

该方案适合用户量不大的场景，若用户规模超过几万，建议使用方案二提升效率。

方案二：提前存储用户UID到数据库（推荐大用户量场景） #

在用户创建时，将UID同步存储到Firestore或Realtime Database并建立索引，后续直接查询数据库即可快速获取结果：

1. 用户创建时同步数据（以Firestore为例） #

可通过Auth触发器或用户注册逻辑实现：

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

// Auth用户创建触发器
exports.syncUserUidToFirestore = functions.auth.user().onCreate((user) => {
  return admin.firestore().collection('user_uids').doc(user.uid).set({
    uid: user.uid,
    email: user.email
  });
});

2. 查询符合条件的用户 #

利用Firestore的范围查询实现类似模糊匹配的效果（需提前为uid字段创建索引）：

async function queryUsersByUidPattern() {
  const targetPattern = "@hayan.com";
  // 利用字符串范围查询匹配包含目标后缀的UID
  const querySnapshot = await admin.firestore()
    .collection('user_uids')
    .where('uid', '>=', targetPattern)
    .where('uid', '<=', targetPattern + '\uf8ff')
    .get();

  const matchedUsers = querySnapshot.docs.map(doc => doc.data());
  console.log(`找到符合条件的用户共${matchedUsers.length}个:`);
  matchedUsers.forEach(user => console.log(user.uid));
}

queryUsersByUidPattern().catch(console.error);

此方案避免了遍历所有Auth用户，查询效率大幅提升，适合用户规模较大的场景。

内容的提问来源于stack exchange，提问作者Maggie_황수경