升级Biometric库至1.1.0后，onAuthenticationError错误处理方案咨询

问题背景 #

将安卓生物识别库从androidx.biometric:biometric:1.0.1升级至1.1.0后，IDE提示switch语句缺少以下新增错误码的case分支：

Switch statement on an int with known associated constant missing case 
 BiometricPrompt.ERROR_HW_NOT_PRESENT,
 BiometricPrompt.ERROR_HW_UNAVAILABLE, 
 BiometricPrompt.ERROR_NO_BIOMETRICS, 
 BiometricPrompt.ERROR_NO_DEVICE_CREDENTIAL, 
 BiometricPrompt.ERROR_NO_SPACE, 
 BiometricPrompt.ERROR_TIMEOUT, 
 BiometricPrompt.ERROR_UNABLE_TO_PROCESS,
 BiometricPrompt.ERROR_VENDOR

升级前的错误处理代码：

private class BioCallback extends AuthenticationCallback {
   public void onAuthenticationError(int errorCode, @NonNull CharSequence errString) {
    switch (errorCode) {
        case ERROR_CANCELED:
        case ERROR_USER_CANCELED:
            endAuth(false);
            runOnUiThread(() -> {
                try {
                    mBiometricPrompt.authenticate(mPromptInfo);
                } catch (Exception e) {
                    FirebaseUtil.logEvent("cmc_crash_fingerprint");
                }
            });
            break;
        case ERROR_NEGATIVE_BUTTON:
        case ERROR_LOCKOUT:
        case ERROR_LOCKOUT_PERMANENT:
        default:
            endAuth(false);
            showLoginScreen();
            break;
    }
    super.onAuthenticationError(errorCode, errString);
   }
}

修改后的代码：

switch (errorCode) {
    case ERROR_CANCELED:
    case ERROR_USER_CANCELED:
    case ERROR_TIMEOUT:
    case ERROR_NO_SPACE:
    case ERROR_UNABLE_TO_PROCESS:
        endAuth(false);
        runOnUiThread(() -> {
            try {
                mBiometricPrompt.authenticate(mPromptInfo);
            } catch (Exception e) {
                FirebaseUtil.logEvent("cmc_crash_fingerprint");
            }
        });
        break;
    case ERROR_NEGATIVE_BUTTON:
    case ERROR_LOCKOUT:
    case ERROR_LOCKOUT_PERMANENT:
    case ERROR_HW_NOT_PRESENT:
    case ERROR_HW_UNAVAILABLE:
    case ERROR_NO_DEVICE_CREDENTIAL:
    case ERROR_NO_BIOMETRICS:
    case ERROR_VENDOR:
    default:
        endAuth(false);
        showLoginScreen();
        break;
}

方案评估：是否最优？潜在问题？ #

你的处理逻辑方向是对的——把可重试的错误归到自动重试分支，不可重试/需用户手动介入的错误归到跳转登录页分支，但部分细节可以优化，同时存在几个潜在风险：

1. 部分错误码的重试合理性存疑 #

• ERROR_NO_SPACE：这个错误是指纹模板存储空间已满，自动重试只会重复触发相同错误，完全解决不了问题。应该把它移到跳转登录页分支，同时给用户弹提示：“指纹存储空间不足，请删除部分指纹后重试”。
• ERROR_UNABLE_TO_PROCESS：传感器无法处理采集到的生物数据，可能是用户操作不当（比如指纹模糊）或临时硬件异常。短时间内重试大概率还是失败，最多给一次重试机会就够了，不然反复弹框会惹恼用户。

2. 硬件类错误的处理可以更友好 #

• ERROR_HW_NOT_PRESENT（无生物识别硬件）、ERROR_NO_BIOMETRICS（未注册任何生物特征）：这两类是永久性错误，跳转登录页没问题，但得给用户明确提示，比如“您的设备不支持指纹识别”或“请先在系统设置中注册指纹”，别让用户摸不着头脑。
• ERROR_HW_UNAVAILABLE（硬件暂时不可用）：比如传感器被占用、过热等，属于临时异常，你现在直接归到跳转分支有点生硬，可以延迟2秒重试一次，不行再跳登录。

3. 重试逻辑存在无限循环风险 #

你当前的重试逻辑是失败就立即调用authenticate，没有次数限制和延迟。如果遇到持续触发的错误（比如硬件故障），会频繁弹认证框，甚至引发ANR或被系统限制。建议：

• 加重试次数上限，比如最多3次
• 每次重试前加1秒左右的延迟，避免频繁触发
• 重试耗尽后自动切换到登录页

4. 错误日志缺失，不利于排查问题 #

现在只有重试抛出异常时才记录日志，其他错误（比如硬件类、存储空间不足）都没记录，以后出问题根本查不到原因。建议每个错误分支都记录错误码和错误信息，方便后续定位。

优化后的参考代码示例 #

private int authRetryCount = 0;
private static final int MAX_RETRY_COUNT = 3;

@Override
public void onAuthenticationError(int errorCode, @NonNull CharSequence errString) {
    // 统一记录所有错误日志
    FirebaseUtil.logEvent("biometric_auth_error", 
                         "error_code", String.valueOf(errorCode), 
                         "error_msg", errString.toString());
    
    switch (errorCode) {
        case ERROR_CANCELED:
        case ERROR_USER_CANCELED:
        case ERROR_TIMEOUT:
            // 可重试错误，限制次数并延迟
            if (authRetryCount < MAX_RETRY_COUNT) {
                authRetryCount++;
                endAuth(false);
                runOnUiThread(() -> {
                    new Handler(Looper.getMainLooper()).postDelayed(() -> {
                        try {
                            mBiometricPrompt.authenticate(mPromptInfo);
                        } catch (Exception e) {
                            FirebaseUtil.logEvent("cmc_crash_fingerprint");
                            showLoginScreen();
                        }
                    }, 1000);
                });
            } else {
                authRetryCount = 0;
                endAuth(false);
                showLoginScreen();
            }
            break;
        case ERROR_UNABLE_TO_PROCESS:
            // 仅重试一次
            if (authRetryCount < 1) {
                authRetryCount++;
                endAuth(false);
                runOnUiThread(() -> {
                    try {
                        mBiometricPrompt.authenticate(mPromptInfo);
                    } catch (Exception e) {
                        FirebaseUtil.logEvent("cmc_crash_fingerprint");
                        showLoginScreen();
                    }
                });
            } else {
                authRetryCount = 0;
                endAuth(false);
                showLoginScreen();
                Toast.makeText(context, "指纹识别失败，请重试或使用密码登录", Toast.LENGTH_SHORT).show();
            }
            break;
        case ERROR_NO_SPACE:
            endAuth(false);
            showLoginScreen();
            Toast.makeText(context, "指纹存储空间不足，请删除部分指纹后重试", Toast.LENGTH_SHORT).show();
            break;
        case ERROR_NEGATIVE_BUTTON:
        case ERROR_LOCKOUT:
        case ERROR_LOCKOUT_PERMANENT:
        case ERROR_NO_DEVICE_CREDENTIAL:
        case ERROR_VENDOR:
            endAuth(false);
            showLoginScreen();
            break;
        case ERROR_HW_NOT_PRESENT:
        case ERROR_NO_BIOMETRICS:
            endAuth(false);
            String tip = errorCode == ERROR_HW_NOT_PRESENT ? 
                "您的设备不支持指纹识别" : "请先在系统设置中注册指纹";
            Toast.makeText(context, tip, Toast.LENGTH_SHORT).show();
            showLoginScreen();
            break;
        case ERROR_HW_UNAVAILABLE:
            // 硬件临时不可用，延迟重试一次
            if (authRetryCount < 1) {
                authRetryCount++;
                endAuth(false);
                runOnUiThread(() -> {
                    new Handler(Looper.getMainLooper()).postDelayed(() -> {
                        try {
                            mBiometricPrompt.authenticate(mPromptInfo);
                        } catch (Exception e) {
                            FirebaseUtil.logEvent("cmc_crash_fingerprint");
                            showLoginScreen();
                        }
                    }, 2000);
                    Toast.makeText(context, "指纹传感器暂时不可用，正在重试...", Toast.LENGTH_SHORT).show();
                });
            } else {
                authRetryCount = 0;
                endAuth(false);
                showLoginScreen();
                Toast.makeText(context, "指纹传感器不可用，请使用密码登录", Toast.LENGTH_SHORT).show();
            }
            break;
        default:
            authRetryCount = 0;
            endAuth(false);
            showLoginScreen();
            break;
    }
    authRetryCount = 0; // 重置重试计数器
    super.onAuthenticationError(errorCode, errString);
}

总结 #

你的初始方案框架没问题，但在错误码归类、重试控制和用户体验上还有优化空间。调整部分错误的分支归属，添加重试限制和延迟，补充用户提示和错误日志，能让整个错误处理流程更健壮、更友好。

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