FirebaseAuth类型转换异常：无法获取精确登录错误码的问题求助

问题原因 #

直接强转task.getException()为FirebaseAuthException抛出ClassCastException，是因为Firebase在部分场景下会将FirebaseAuthException包装在顶层FirebaseException的getCause()中，而非直接返回FirebaseAuthException实例。同时新版本Firebase Auth默认模糊了错误消息，仅返回通用的INVALID_LOGIN_CREDENTIALS，但可通过错误码区分具体问题。

正确获取错误码的方法 #

不要直接强制类型转换，先判断异常本身或其cause的类型，再提取错误码：

Exception exception = task.getException();
String errorCode = null;

// 优先检查异常本身是否为FirebaseAuthException
if (exception instanceof FirebaseAuthException) {
    errorCode = ((FirebaseAuthException) exception).getErrorCode();
}
// 若不是，检查异常的底层cause
else if (exception != null && exception.getCause() instanceof FirebaseAuthException) {
    errorCode = ((FirebaseAuthException) exception.getCause()).getErrorCode();
}

// 根据错误码处理具体场景
if (errorCode != null) {
    switch (errorCode) {
        case "ERROR_WRONG_PASSWORD":
            // 处理密码错误逻辑
            break;
        case "ERROR_USER_NOT_FOUND":
            // 处理用户不存在逻辑
            break;
        case "ERROR_INVALID_EMAIL":
            // 处理邮箱格式错误逻辑
            break;
        case "ERROR_USER_DISABLED":
            // 处理用户被禁用逻辑
            break;
        default:
            // 处理其他认证错误
            break;
    }
}

完整登录回调示例 #

firebaseAuth.signInWithEmailAndPassword(inputEmail, inputPassword)
    .addOnCompleteListener(task -> {
        if (!task.isSuccessful()) {
            Exception exception = task.getException();
            if (exception == null) return;

            String errorCode = null;
            if (exception instanceof FirebaseAuthException) {
                errorCode = ((FirebaseAuthException) exception).getErrorCode();
            } else if (exception.getCause() instanceof FirebaseAuthException) {
                errorCode = ((FirebaseAuthException) exception.getCause()).getErrorCode();
            }

            if (errorCode != null) {
                // 根据错误码展示对应提示
                switch (errorCode) {
                    case "ERROR_WRONG_PASSWORD":
                        Toast.makeText(this, "密码错误，请重新输入", Toast.LENGTH_SHORT).show();
                        break;
                    case "ERROR_USER_NOT_FOUND":
                        Toast.makeText(this, "该邮箱未注册", Toast.LENGTH_SHORT).show();
                        break;
                    case "ERROR_INVALID_EMAIL":
                        Toast.makeText(this, "邮箱格式不正确", Toast.LENGTH_SHORT).show();
                        break;
                    default:
                        Toast.makeText(this, "登录失败：" + exception.getMessage(), Toast.LENGTH_SHORT).show();
                        break;
                }
            } else {
                Toast.makeText(this, "登录失败：" + exception.getMessage(), Toast.LENGTH_SHORT).show();
            }
        } else {
            // 登录成功逻辑
            Toast.makeText(this, "登录成功", Toast.LENGTH_SHORT).show();
        }
    });

注意事项 #

• Firebase Auth 22.x版本部分错误码常量可能已被标记为过时，建议直接使用字符串值判断，避免依赖过时API。
• 模糊错误消息是Firebase的安全设计，防止恶意用户通过错误信息枚举已注册邮箱，通过错误码区分场景是合规的做法。

内容的提问来源于stack exchange，提问作者Surya Pratap Raj