Firebase Auth同邮箱账号关联问题：Apple登录触发auth/email-already-in-use错误

问题核心 #

1. 已开启Firebase控制台的「Authentication > Settings > User Account Linking > Link accounts that use the same email」设置，但使用Google创建用户后，用同一邮箱的Apple登录仍触发auth/email-already-in-use错误。
2. 错误处理中尝试调用signInWithCredential(freshCredentials)时，因freshCredentials为undefined（该错误的authCredential字段为null），导致TypeError: Cannot read property 'providerId' of undefined。

为什么会触发auth/email-already-in-use？ #

当前用户是匿名用户（控制台输出Attempt to link with anonymous user..），调用linkWithCredential时，Firebase会尝试将Apple凭证关联到匿名用户，这相当于要给匿名用户绑定该邮箱，但该邮箱已被Google账号占用，因此抛出auth/email-already-in-use。而「同一邮箱关联账号」的设置仅针对非匿名用户的跨提供商登录场景，不会自动处理匿名用户与已有邮箱账号的关联。

解决方案 #

1. 修复错误处理中的空值问题 #

首先避免在freshCredentials为undefined时调用signInWithCredential，针对auth/email-already-in-use错误单独处理；同时调整登录/关联逻辑，适配匿名用户场景。

修正后的代码示例 #

const createUserWithCredentials = async (
  credential: FirebaseAuthTypes.AuthCredential,
) => {
  try {
    const currentUser = auth().currentUser;
    let res: FirebaseAuthTypes.UserCredential;
    
    if (currentUser && currentUser.isAnonymous) {
      // 匿名用户：先尝试用凭证登录，而非直接关联
      try {
        res = await auth().signInWithCredential(credential);
        // 登录成功后，清理原匿名用户
        await currentUser.delete();
      } catch (signInError) {
        if (signInError.code === 'auth/email-already-in-use') {
          // 获取该邮箱已绑定的登录方式
          const email = credential.providerData[0]?.email;
          if (!email) throw new Error('无法获取邮箱信息');
          
          const signInMethods = await auth().fetchSignInMethodsForEmail(email);
          if (signInMethods.length > 0) {
            // 此处可根据业务逻辑，要么提示用户用已有方式登录后再关联，要么自动完成登录+关联
            console.log(`该邮箱已绑定${signInMethods.join(', ')}，请先登录对应账号`);
            throw new Error(`邮箱已绑定其他账号，请使用${signInMethods[0]}登录`);
          }
        } else {
          throw signInError;
        }
      }
    } else if (currentUser) {
      // 非匿名用户：直接关联新凭证
      res = await currentUser.linkWithCredential(credential);
    } else {
      // 无当前用户：直接用凭证登录/注册
      res = await auth().signInWithCredential(credential);
    }
    return res;
  } catch (error) {
    console.log({ code: error.code });
    // 处理其他可自动关联的错误
    if (
      error.code === 'auth/provider-already-linked' ||
      error.code === 'auth/credential-already-in-use'
    ) {
      const freshCredentials = error.userInfo.authCredential;
      if (freshCredentials) {
        return await auth().signInWithCredential(freshCredentials);
      }
    }
    throw error;
  }
};

关键逻辑说明 #

• 匿名用户优先尝试登录而非关联，避免触发邮箱占用错误。
• 捕获auth/email-already-in-use时，通过fetchSignInMethodsForEmail获取已有登录方式，引导用户完成登录后再关联新凭证。
• 所有调用signInWithCredential前先校验凭证是否存在，彻底避免空值报错。

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