如何使用Firebase Admin SDK从邮箱列表筛选Auth服务已存在用户的邮箱

AI 小北

2026-7-24

解决方法

核心思路：用`Promise.allSettled()`替代`Promise.all()`

Promise.allSettled()会等待所有异步请求完成，不管单个请求成功还是失败，不会因为某一个邮箱未找到就终止整个批量操作，完美适配你的场景。

具体实现步骤

封装单个邮箱的校验函数
为每个邮箱调用getUserByEmail()，专门捕获auth/user-not-found错误，返回包含邮箱和校验状态的结果：

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

async function checkEmailExists(email) {
  try {
    await admin.auth().getUserByEmail(email);
    return { email, exists: true };
  } catch (error) {
    if (error.code === 'auth/user-not-found') {
      return { email, exists: false };
    }
    // 其他异常（比如权限问题、网络错误）直接抛出，按需处理
    throw error;
  }
}

批量校验并筛选已注册邮箱
用Promise.allSettled()执行所有校验请求，之后从结果中过滤出已注册的邮箱：

async function filterRegisteredEmails(emailArray) {
  // 并行执行所有邮箱校验
  const results = await Promise.allSettled(
    emailArray.map(email => checkEmailExists(email))
  );

  // 提取成功校验且确实存在的邮箱
  const registeredEmails = results
    .filter(item => item.status === 'fulfilled' && item.value.exists)
    .map(item => item.value.email);

  return registeredEmails;
}

云函数中调用示例

exports.filterRegisteredUsers = functions.https.onCall(async (data, context) => {
  const { emailList } = data;
  if (!Array.isArray(emailList)) {
    throw new functions.https.HttpsError('invalid-argument', '邮箱列表必须是数组格式');
  }

  const registeredEmails = await filterRegisteredEmails(emailList);
  return { registeredEmails };
});