企业官网建设流程全解析

Android-Goldfinger 前置检查必修课：canAuthenticate 的 3 种用法避免崩溃

【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-Goldfinger

Android-Goldfinger 是一款专门简化 Android 生物识别认证（Biometric authentication）接入的轻量级开源库，它把繁琐的BiometricPrompt与加密解密逻辑封装成几行简洁的 API。无论你是刚接触指纹登录的新手，还是在已有支付、密码保险箱功能中集成生物识别，调用生物识别弹窗之前的第一课，都是学会正确使用canAuthenticate前置检查。本文用 3 种实用用法，帮你彻底避开「设备无硬件」「未录入指纹」导致的运行时崩溃。

为什么必须做 canAuthenticate 前置检查？

很多崩溃的根源在于：用户设备根本没有指纹硬件，或者系统设置里一个指纹都没录入，你却直接弹出了生物识别对话框。系统会立刻回调错误码，处理不当轻则弹窗异常，重则直接 Crash。

canAuthenticate正是官方提供的「能力探测」接口，它会在调用前告诉你当前设备是否满足认证条件。Android-Goldfinger 把它包装成了Goldfinger接口上的两个方法，源码位于core/src/main/java/co/infinum/goldfinger/Goldfinger.java，核心实现在core/src/main/java/co/infinum/goldfinger/GoldfingerImpl.java：内部调用BiometricManager.canAuthenticate()，返回值等于BIOMETRIC_SUCCESS时才返回true。

用法一：无参数版本 canAuthenticate()（已被标记废弃）

这是最早期也是最简单的写法，只判断「当前默认认证方式是否可用」：

if (goldfinger.canAuthenticate()) { // 可以发起生物识别认证 }

它在库中已被标注@Deprecated，原因是它无法区分认证类型，你无法得知探测的是「指纹」还是「人脸」，也无法控制强弱安全等级。新手建议直接跳过它，虽然它不会报错，但属于「能用但不推荐」的历史接口。

用法二：带参数版本 canAuthenticate(int authenticators)（推荐）

这是官方推荐的现代用法，通过传入认证类型常量，精确探测设备支持哪种生物识别。Android-Goldfinger 在Goldfinger.java中明确建议使用带参版本，并直接对接BiometricManager.canAuthenticate(int)。

最常见的两种长尾场景：

2.1 探测强生物识别（BIOMETRIC_STRONG）

boolean strongReady = goldfinger.canAuthenticate( BiometricManager.Authenticators.BIOMETRIC_STRONG );

BIOMETRIC_STRONG代表 Class 3 级强生物识别（如屏下指纹、3D 人脸），安全性最高，适合支付、转账等敏感操作。

2.2 探测弱生物识别（BIOMETRIC_WEAK）

boolean weakReady = goldfinger.canAuthenticate( BiometricManager.Authenticators.BIOMETRIC_WEAK );

BIOMETRIC_WEAK代表 Class 2 级弱生物识别，适合普通的应用解锁场景。你可以根据业务安全等级，分别控制按钮是否可点击，示例工程example/src/main/java/co/infinum/example/ChooseImplementationActivity.java中就有完整的强弱类型开关演示：

strongCheckBox.setEnabled(goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_STRONG)); weakCheckBox.setEnabled(goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK));

用法三：组合探测 + 兜底方案（最稳妥的防崩溃组合拳）

只调用一次canAuthenticate还不够，最稳妥的姿势是「组合探测 + 兜底降级」。Android-Goldfinger 额外提供了两个辅助方法，帮你定位问题到底出在哪一环：

推荐的完整三段式检查代码如下：

Goldfinger goldfinger = new Goldfinger.Builder(context).build(); if (!goldfinger.hasBiometricHardware(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 无硬件：隐藏指纹入口，不要弹出任何生物识别对话框 return; } if (!goldfinger.hasEnrolledBiometrics(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 未录入：引导用户去系统设置添加指纹/人脸 return; } if (!goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 仍然不可用：兜底降级为账号密码登录 return; } // 全部通过，安全地发起认证 goldfinger.authenticate(params, callback);

这套「硬件 → 录入 → 可用」的三级检查，几乎覆盖了所有可能导致崩溃的边界情况，也是金融类 App 的标准做法。

额外防坑提示：老机型与返回值语义

• Android 6.0 以下机型：库会自动回退到GoldfingerMock（见core/src/main/java/co/infinum/goldfinger/GoldfingerMock.java），此时canAuthenticate恒返回false，你的检查逻辑天然安全，不会崩溃。
• 返回值是布尔而非状态码：Android-Goldfinger 帮你把复杂的错误码转换成了true/false，你不用再关心BIOMETRIC_ERROR_NO_HARDWARE这类常量，代码可读性更高。
• 每次进入页面都应重新检查：用户可能在系统设置中随时删除指纹，建议在onResume中刷新按钮可用状态，而不是只在首次启动时检查一次。

总结：一行检查，杜绝九成崩溃

记住这三条黄金规则，生物识别接入从此不踩坑：

1. ✅ 优先使用canAuthenticate(int authenticators)，明确指定认证类型；
2. ✅ 配合hasBiometricHardware与hasEnrolledBiometrics做三级探测；
3. ✅ 检查不通过时优雅降级，绝不强行弹窗。

掌握了 canAuthenticate 的这 3 种用法，你的 Android 生物识别认证就能在各类机型上稳定运行，把崩溃风险降到最低。配合 Android-Goldfinger 简洁的 API 设计，从检查到认证，整个过程不过十余行代码，强烈推荐在下一个项目里直接体验。

【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-Goldfinger