Android Studio中Firebase手机号与邮箱密码认证用户ID关联方法

问题根源与解决方案 #

你遇到的「该邮箱已被其他账户使用」错误，核心原因是在verifyOtp方法中同时调用了linkWithCredential和signInWithPhoneAuthCredential——前者是要把手机号凭证关联到当前已登录的邮箱用户，后者却尝试用手机号凭证登录新用户（或切换到已存在的手机号用户），两者冲突导致报错。

正确的流程应该是：邮箱登录成功后，用当前已登录的用户对象，直接将验证通过的手机号凭证关联到该用户，不需要再单独调用手机号登录接口。

1. 修复OTPVerificationActivity的verifyOtp方法

删除多余的signInWithPhoneAuthCredential调用，将标记验证状态和跳转逻辑移到linkWithCredential的成功回调中：

private fun verifyOtp(otpbackend: String?) {
    val otp = binding.editTextText1.text.toString() +
            binding.editTextText2.text.toString() +
            binding.editTextText3.text.toString() +
            binding.editTextText4.text.toString() +
            binding.editTextText5.text.toString() +
            binding.editTextText6.text.toString()

    if (otp.length != 6) {
        Toast.makeText(this, "请输入完整的6位OTP", Toast.LENGTH_SHORT).show()
        return
    }

    if (otpbackend == null) {
        Toast.makeText(this, "请检查网络连接", Toast.LENGTH_SHORT).show()
        return
    }

    binding.progressBar.visibility = View.VISIBLE
    binding.verifybutton.visibility = View.GONE

    val credential = PhoneAuthProvider.getCredential(otpbackend, otp)

    auth.currentUser?.let { currentUser ->
        currentUser.linkWithCredential(credential)
            .addOnCompleteListener(this) { task ->
                binding.progressBar.visibility = View.GONE
                binding.verifybutton.visibility = View.VISIBLE
                if (task.isSuccessful) {
                    Log.d(TAG, "linkWithCredential:success，用户ID：${currentUser.uid}")
                    // 关联成功后标记OTP验证状态并跳转主页面
                    markOTPVerification(currentUser.uid)
                    navigateToMainActivity()
                } else {
                    Log.w(TAG, "linkWithCredential:failure", task.exception)
                    when (task.exception) {
                        is FirebaseAuthInvalidCredentialsException -> {
                            Toast.makeText(this, "无效的OTP", Toast.LENGTH_SHORT).show()
                        }
                        is FirebaseAuthUserCollisionException -> {
                            Toast.makeText(this, "该手机号已绑定其他账户，请更换手机号或登录对应账户", Toast.LENGTH_SHORT).show()
                        }
                        else -> {
                            Toast.makeText(this, "关联失败：${task.exception?.message}", Toast.LENGTH_SHORT).show()
                        }
                    }
                }
            }
    } ?: run {
        // 当前无登录用户，说明邮箱登录状态丢失，返回登录页
        Toast.makeText(this, "登录状态失效，请重新登录", Toast.LENGTH_SHORT).show()
        startActivity(Intent(this, LoginActivity::class.java))
        finish()
    }
}

2. 删除多余方法

直接删除signInWithPhoneAuthCredential方法，因为关联操作已完成用户身份绑定，无需额外登录。

关键说明

• 关联成功后，该Firebase账户同时支持邮箱密码和手机号两种登录方式，后续用户用任意方式登录都会获取同一个用户ID。
• 如果触发FirebaseAuthUserCollisionException，说明该手机号已被其他Firebase账户绑定，需提示用户更换手机号或登录对应账户。
• 确保注册邮箱用户时，已将手机号存入Firestore（你的现有代码已实现此逻辑，无需修改）。

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