Firebase中如何关联/合并自定义令牌与手机认证创建的账号

我来帮你搞定这个账号关联的问题，核心是要让自定义令牌和已有的手机认证账号绑定，避免每次登录都创建新账号。下面分两种场景给你具体方案：

一、最优方案：基于已有Firebase账号生成自定义令牌 #

这是最直接的解决方式——生成自定义令牌时，直接使用已有手机认证账号的UID，这样客户端用这个令牌登录时，会直接登录到对应UID的账号，不会创建新账号。

步骤1：后端通过手机号获取已有用户的UID #

首先，你需要在后端用Firebase Admin SDK，根据用户的手机号查询到对应的已有账号UID：

const admin = require('firebase-admin');
// 确保已经初始化Admin SDK（使用服务账号密钥）

async function getExistingUserUid(phoneNumber) {
  try {
    // 通过手机号查询用户记录
    const userRecord = await admin.auth().getUserByPhoneNumber(phoneNumber);
    return userRecord.uid;
  } catch (error) {
    if (error.code === 'auth/user-not-found') {
      // 该手机号还没有注册过，可以选择创建新账号或者提示用户
      return null;
    }
    console.error('查询用户失败:', error);
    throw error;
  }
}

步骤2：用已有UID生成自定义令牌 #

拿到UID后，调用Admin SDK的createCustomToken方法生成令牌：

async function generateCustomToken(uid) {
  try {
    const customToken = await admin.auth().createCustomToken(uid);
    return customToken;
  } catch (error) {
    console.error('生成自定义令牌失败:', error);
    throw error;
  }
}

步骤3：客户端用令牌登录 #

客户端拿到令牌后，调用Firebase Auth的登录方法，此时会直接登录到已有账号：

// Web示例
firebase.auth().signInWithCustomToken(customToken)
  .then((userCredential) => {
    // 登录成功，user就是原有手机认证账号
    const user = userCredential.user;
    console.log('登录成功，用户UID:', user.uid);
  })
  .catch((error) => {
    console.error('登录失败:', error);
  });

二、补救方案：合并已创建的自定义令牌账号与手机认证账号 #

如果已经不小心生成了新账号，你可以通过账号关联功能合并两个账号。注意：这个操作需要用户至少登录其中一个账号，然后将另一个账号的凭证关联过来。

示例：先登录自定义令牌账号，再关联手机认证凭证 #

1. 用户先用自定义令牌登录新账号；
2. 引导用户完成手机验证码验证（如果用户偶尔能收到验证码的话）；
3. 生成PhoneAuthCredential，然后调用linkWithCredential关联：

// Web示例，假设已经获取到手机认证的credential
const user = firebase.auth().currentUser;
user.linkWithCredential(phoneAuthCredential)
  .then((userCredential) => {
    // 关联成功，两个账号合并为一个
    const mergedUser = userCredential.user;
  })
  .catch((error) => {
    console.error('关联失败:', error);
  });

不过这个方案依赖用户能完成手机验证，所以如果用户长期收不到验证码，还是优先用第一个方案更稳妥。

关键说明 #

你之前登录时创建新账号的原因是：生成自定义令牌时没有指定已有账号的UID，Firebase会自动生成一个新的UID并创建账号。只要你在生成令牌时传入已有手机认证账号的UID，就能直接登录原有账号，不会新建。

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