Firebase Auth微软登录报错：同邮箱不同凭证账户已存在

问题背景 #

管理员通过Firebase Auth创建了仅含邮箱+UID的用户账户（无登录提供商），用户使用微软账户登录同邮箱时，触发错误：

"An account already exists with the same email address but different sign-in credentials. Sign in using a provider associated with this email address."

Google登录无此问题，因为其Provider默认处理了该场景，而微软Provider需要手动介入。

核心解决方案 #

通过Firebase云函数+客户端协作，将微软登录凭证关联到已存在的无提供商账户，保留原UID：

1. 部署云函数处理凭证关联

创建云函数，使用Firebase Admin SDK完成凭证与用户的关联，并返回自定义登录token：

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

exports.linkMicrosoftCredential = functions.https.onCall(async (data, context) => {
  const { email, credentialJson } = data;
  try {
    // 获取目标用户（管理员创建的无提供商账户）
    const user = await admin.auth().getUserByEmail(email);
    // 解析微软登录凭证
    const microsoftCredential = admin.auth.OAuthProvider('microsoft.com').credentialFromJSON(credentialJson);
    // 关联凭证到用户
    await admin.auth().linkUserWithCredential(user.uid, microsoftCredential);
    // 生成自定义登录token返回给客户端
    const customToken = await admin.auth().createCustomToken(user.uid);
    return { customToken };
  } catch (error) {
    throw new functions.https.HttpsError('internal', error.message);
  }
});

2. 修改客户端微软登录代码

捕获冲突错误后，调用云函数完成关联并登录：

@override
Future<User?> signInWithMicrosoft() async {
  try {
    final microsoftProvider = MicrosoftAuthProvider();
    return (await FirebaseAuth.instance.signInWithPopup(microsoftProvider)).user;
  } on FirebaseAuthException catch (e) {
    // 处理账户凭证冲突错误
    if (e.code == 'account-exists-with-different-credential') {
      final email = e.email;
      final pendingCredential = e.credential;

      if (email != null && pendingCredential != null) {
        try {
          // 将凭证转为JSON格式传递给云函数
          final credentialJson = pendingCredential.toJson();
          // 调用云函数
          final callable = FirebaseFunctions.instance.httpsCallable('linkMicrosoftCredential');
          final result = await callable.call({
            'email': email,
            'credentialJson': credentialJson,
          });
          // 使用云函数返回的自定义token登录
          final customToken = result.data['customToken'];
          final userCredential = await FirebaseAuth.instance.signInWithCustomToken(customToken);
          return userCredential.user;
        } catch (funcError) {
          // 处理云函数调用异常
          print('云函数调用失败: ${funcError.toString()}');
          rethrow;
        }
      }
    }
    // 抛出其他未处理的Auth错误
    rethrow;
  } catch (generalError) {
    print('登录异常: ${generalError.toString()}');
    return null;
  }
}

关键说明 #

• 云函数必须启用Firebase Admin SDK权限，部署前确保已完成Admin初始化
• 管理员创建用户时，需保证邮箱唯一，且Firestore中的用户记录与Auth账户UID对应
• 该方案保留原用户UID，完全匹配业务需求

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