Firebase：如何检查用户是否已通过手机号注册账号

Firebase 默认的手机号认证逻辑是：当用户用已注册过的手机号完成验证后，会直接登录对应的现有账号，不会主动提示“账号已存在”。要实现你要的效果，我们可以通过验证完成后检查用户元数据的方式来判断是否为重复注册，具体实现步骤如下：

核心思路 #

Firebase Auth 的用户对象包含 metadata 字段，其中 creationTime（账号创建时间）和 lastSignInTime（最后登录时间）是关键判断依据：

• 如果两个时间相同，说明这是用户首次登录（即刚创建账号）
• 如果时间不同，说明该手机号对应的账号已存在，用户是在重复尝试注册

前端代码示例（JavaScript） #

1. 发送验证码流程 #

先完成常规的手机号验证码发送逻辑，注意配置 reCAPTCHA 验证：

// 获取用户输入的手机号
const phoneNumber = document.getElementById('phone-input').value;
// 初始化 reCAPTCHA 验证器（需要页面上有 id 为 recaptcha-container 的元素）
const appVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container', {
  'size': 'invisible',
  'callback': (response) => {
    // reCAPTCHA 验证成功后的回调
  }
});

// 请求发送验证码
firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier)
  .then((confirmationResult) => {
    // 保存验证结果对象，用于后续校验验证码
    window.confirmationResult = confirmationResult;
    alert("验证码已发送，请查收");
  })
  .catch((error) => {
    // 处理发送验证码的错误（比如无效手机号、reCAPTCHA 验证失败等）
    console.error("发送验证码失败：", error);
    alert("发送验证码失败，请检查手机号是否正确");
  });

2. 验证验证码并判断账号是否存在 #

当用户输入验证码后，完成验证并检查用户状态：

// 获取用户输入的验证码
const verificationCode = document.getElementById('code-input').value;

// 验证验证码
window.confirmationResult.confirm(verificationCode)
  .then((result) => {
    const user = result.user;
    // 判断是否为新用户
    const isNewUser = user.metadata.creationTime === user.metadata.lastSignInTime;
    
    if (!isNewUser) {
      // 账号已存在，显示提示
      alert("账号已存在，请直接登录");
      // 可选：跳转到登录后的首页或个人中心
      window.location.href = "/dashboard";
    } else {
      // 新用户，继续完成注册流程（比如完善个人资料）
      alert("注册成功，请完善你的个人信息");
      window.location.href = "/profile-setup";
    }
  })
  .catch((error) => {
    // 处理验证码错误（比如验证码无效、过期等）
    console.error("验证码验证失败：", error);
    alert("验证码无效，请重新输入");
  });

注意事项 #

• Firebase 前端 SDK 没有直接查询手机号是否已注册的 API（出于隐私和安全考虑），所以只能通过认证后的用户元数据来判断
• 如果用户之前用该手机号注册过账号，后来删除了账号，再次注册时 creationTime 和 lastSignInTime 会相同，会被视为新用户，这符合逻辑
• 如果你需要在后端提前校验手机号是否存在，可以使用 Firebase Admin SDK 的 getUserByPhoneNumber 方法，但前端无法直接调用该接口，需要自己搭建后端接口做中转

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