Flutter调用linkWithCredential()触发email-already-in-use异常求助

问题原因 #

你遇到的email-already-in-use异常，本质是因为要关联的邮箱已存在独立Firebase账号（比如单独用邮箱密码创建的账号）。即便你在控制台开启了"关联使用同一邮箱的账号"，该设置仅针对首次登录时自动关联同邮箱的不同登录方式，无法直接支持已登录账号主动调用linkWithCredential()合并已存在的独立账号。

解决方案 #

正确流程需先检查目标邮箱是否已绑定独立账号，再分场景处理：

1. 若邮箱无关联账号：直接执行关联操作
2. 若邮箱已存在独立账号：先登录该账号，再将其与当前谷歌账号合并

完整代码示例 #

import 'package:firebase_auth/firebase_auth.dart';
import 'package:google_sign_in/google_sign_in.dart';

final googleSignIn = GoogleSignIn();
final auth = FirebaseAuth.instance;

// 谷歌登录函数（保留原有实现）
Future<UserCredential> signInWithGoogle() async {
  final googleSignInAccount = await googleSignIn.signIn();

  if (googleSignInAccount != null) {
    final googleSignInAuthentication =
        await googleSignInAccount.authentication;

    final credential = GoogleAuthProvider.credential(
      accessToken: googleSignInAuthentication.accessToken,
      idToken: googleSignInAuthentication.idToken,
    );

    return auth.signInWithCredential(credential);
  } else {
    throw FirebaseAuthException(
      code: 'ERROR_GOOGLE_LOGIN_FAILED',
      message: 'Failed to login with google',
    );
  }
}

// 账号关联处理函数
Future<void> linkAccounts(String email, String password, UserCredential googleUserCredential) async {
  // 检查目标邮箱已绑定的登录方式
  final signInMethods = await auth.fetchSignInMethodsForEmail(email);

  if (signInMethods.isEmpty) {
    // 场景1：邮箱无关联账号，直接关联
    final emailCredential = EmailAuthProvider.credential(email: email, password: password);
    await googleUserCredential.user?.linkWithCredential(emailCredential);
  } else {
    // 场景2：邮箱已存在独立账号，执行合并
    if (signInMethods.contains(EmailAuthProvider.PROVIDER_ID)) {
      try {
        // 先登录邮箱密码账号
        final emailUserCredential = await auth.signInWithCredential(
          EmailAuthProvider.credential(email: email, password: password)
        );
        // 提取谷歌账号的凭证
        final googleCredential = GoogleAuthProvider.credential(
          idToken: (googleUserCredential.credential as GoogleAuthCredential).idToken,
          accessToken: (googleUserCredential.credential as GoogleAuthCredential).accessToken,
        );
        // 合并两个账号
        await emailUserCredential.user?.linkWithCredential(googleCredential);
      } on FirebaseAuthException catch (e) {
        // 处理异常：如密码错误、账号禁用等
        print(e.code);
      }
    }
  }
}

// 调用示例
void main() async {
  final googleUserCredential = await signInWithGoogle();
  await linkAccounts("user@example.com", "password123", googleUserCredential);
}

注意事项 #

• 确认Firebase控制台Auth > 设置 > 进阶中，已勾选"启用使用相同电子邮件地址的账号合并"
• 合并操作需要用户提供邮箱账号的正确密码，因为需先登录该独立账号
• 合并完成后，两个账号会统一为一个，原有用户数据将保留在合并后的账号中

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