Firebase（Swift）中关联电话与邮箱认证提供商方案咨询

我来帮你解决Firebase中邮箱和电话认证关联的问题，这个场景我之前也处理过——核心是利用Firebase的用户认证提供商链接功能，把两种认证方式绑定到同一个用户账号上，这样不管用邮箱还是电话登录，都是同一个UID，用户信息也不会丢失。下面分场景给你详细的Swift实现方案：

Firebase允许将多个认证提供商（比如邮箱、电话、Google等）关联到同一个用户账号，关联后用户可以通过任意一种方式登录，且所有方式都指向同一个UID。操作的关键是：必须先让用户通过其中一种方式完成登录，再调用Firebase的link(with:)方法将另一种认证的凭证关联到当前已登录的用户。

假设用户已经用邮箱密码完成登录，现在要绑定手机号：

// 1. 确保当前有已登录的邮箱用户
guard let currentUser = Auth.auth().currentUser else {
    print("请先让用户用邮箱登录")
    return
}

// 2. 先完成Firebase电话验证流程，拿到verificationID和用户输入的验证码
// （这里省略获取verificationID和验证码的代码，你应该已经有这部分逻辑了）
let verificationID = "从Firebase获取的验证ID"
let userInputCode = "用户输入的6位验证码"

// 3. 生成电话认证凭证
let phoneCredential = PhoneAuthProvider.provider().credential(
    withVerificationID: verificationID,
    verificationCode: userInputCode
)

// 4. 关联凭证到当前用户
currentUser.link(with: phoneCredential) { result, error in
    if let error = error {
        // 处理关联错误
        if let authError = error as NSError?, 
           authError.code == AuthErrorCode.accountExistsWithDifferentCredential.rawValue {
            // 错误提示：这个手机号已经绑定到另一个账号了
            if let pendingCredential = authError.userInfo[AuthErrorUserInfoPendingCredentialKey] as? AuthCredential {
                // 这里可以提示用户，让他们用该手机号对应的原账号登录，再关联当前邮箱；
                // 或者引导用户输入原账号的认证信息（比如邮箱密码），完成账号合并
                print("该手机号已绑定其他账号，请先登录原账号")
            }
        } else {
            print("关联失败：\(error.localizedDescription)")
        }
        return
    }
    
    // 关联成功！现在用户可以用邮箱或电话登录同一个账号
    print("电话认证关联成功，当前用户提供商：\(currentUser.providerData)")
}

如果用户先用电话完成登录，现在要绑定邮箱密码：

// 1. 确保当前有已登录的电话用户
guard let currentUser = Auth.auth().currentUser else {
    print("请先让用户用电话登录")
    return
}

// 2. 生成邮箱认证凭证
let email = "用户的邮箱地址"
let password = "用户设置的邮箱密码"
let emailCredential = EmailAuthProvider.credential(
    withEmail: email,
    password: password
)

// 3. 关联凭证到当前用户
currentUser.link(with: emailCredential) { result, error in
    if let error = error {
        if let authError = error as NSError?, 
           authError.code == AuthErrorCode.accountExistsWithDifferentCredential.rawValue {
            // 错误提示：这个邮箱已经绑定到另一个账号了
            print("该邮箱已绑定其他账号，请先登录原账号")
        } else {
            print("关联失败：\(error.localizedDescription)")
        }
        return
    }
    
    // 关联成功！现在用户可以用电话或邮箱登录同一个账号
    print("邮箱认证关联成功，当前用户提供商：\(currentUser.providerData)")
}

如果用户尝试用电话登录，但这个手机号已经绑定到一个邮箱账号（或者反过来），Firebase会抛出accountExistsWithDifferentCredential错误。这时候需要引导用户完成账号合并：

// 举个例子：用户尝试用电话登录，但手机号已绑定到邮箱账号
PhoneAuthProvider.provider().verifyPhoneNumber("+8613xxxxxxxxx", uiDelegate: nil) { verificationID, error in
    guard let verificationID = verificationID, error == nil else {
        print("获取验证ID失败：\(error!.localizedDescription)")
        return
    }
    
    // 用户输入验证码后，生成电话凭证
    let userCode = "用户输入的验证码"
    let phoneCredential = PhoneAuthProvider.provider().credential(
        withVerificationID: verificationID,
        verificationCode: userCode
    )
    
    // 尝试用电话凭证登录
    Auth.auth().signIn(with: phoneCredential) { result, error in
        if let error = error {
            if let authError = error as NSError?, 
               authError.code == AuthErrorCode.accountExistsWithDifferentCredential.rawValue {
                // 拿到待关联的凭证（这里是电话凭证）
                guard let pendingCredential = authError.userInfo[AuthErrorUserInfoPendingCredentialKey] as? AuthCredential else {
                    return
                }
                
                // 提示用户输入该手机号绑定的邮箱账号密码
                let userEmail = "用户输入的邮箱"
                let userPassword = "用户输入的密码"
                let emailCredential = EmailAuthProvider.credential(withEmail: userEmail, password: userPassword)
                
                // 先登录邮箱账号
                Auth.auth().signIn(with: emailCredential) { signInResult, signInError in
                    if let signInError = signInError {
                        print("邮箱登录失败：\(signInError.localizedDescription)")
                        return
                    }
                    
                    // 登录成功后，将电话凭证关联到该邮箱账号
                    signInResult?.user.link(with: pendingCredential) { linkResult, linkError in
                        if let linkError = linkError {
                            print("账号合并失败：\(linkError.localizedDescription)")
                        } else {
                            print("账号合并成功！现在可以用邮箱或电话登录同一个账号")
                        }
                    }
                }
            } else {
                print("登录失败：\(error.localizedDescription)")
            }
            return
        }
        
        // 正常登录成功（该手机号未绑定其他账号），后续可以关联邮箱
        print("电话登录成功")
    }
}

• 关联操作必须在用户已认证状态下执行，也就是必须先登录其中一种方式。
• 关联成功后，用户的providerData数组会包含两种认证方式的信息，UID始终保持一致。
• 如果用户在不同方式下有独立的Firestore/Realtime Database数据，关联后需要手动迁移旧数据到目标账号，再删除旧账号的冗余数据。

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