18、测试与调试：使用模拟器测试、真机调试技巧、日志分析、常见问题排查
说实话，虹膜识别这个功能，在模拟器上跑和真机上跑，完全是两码事。我见过不少新手，在模拟器上测得好好的，一上真机就翻车。嗯，今天我们就来聊聊，怎么把这套测试流程走顺。
模拟器测试：能测什么，不能测什么
Android 模拟器本身并不具备真实的虹膜摄像头硬件。所以，你指望它模拟出「眼睛靠近了」「光线太暗了」这种场景，基本没戏。但模拟器也不是完全没用。
能测的：
- 权限申请流程是否正常弹出
- BiometricPrompt 的 UI 是否能正常显示
- 取消操作、重试逻辑是否走得通
- Activity 生命周期切换时，识别状态是否丢失
不能测的：
- 实际的虹膜图像采集质量
- 不同光照条件下的识别成功率
- 传感器延迟和帧率
- 安全芯片（TEE）的交互
真机调试技巧：别光靠 Log
真机调试，我个人觉得最核心的一点是——你得能看到摄像头在干什么。很多厂商（比如三星、华为）在开发者选项里提供了「显示摄像头预览」或者「显示传感器数据」的开关。打开它，你就能看到虹膜摄像头当前捕捉到的画面。
为什么要看这个？
- 能判断摄像头是否被遮挡
- 能看到红外补光灯是否亮起
- 能确认画面里有没有人脸或眼睛
我曾经遇到一个 case，用户反馈说「识别不了」。我打开预览一看，好家伙，摄像头画面全黑。最后发现是红外补光灯的驱动没加载成功。这种问题，光看 Log 是很难定位的。
日志分析：抓住关键信息
Android 的日志系统很强大，但也很嘈杂。针对虹膜识别，我建议你重点关注这几个 TAG：
| TAG | 含义 | 常见内容 |
|---|---|---|
| BiometricService | 系统生物识别服务 | 认证状态切换、错误码 |
| IrisService | 虹膜识别具体服务 | 传感器状态、图像质量评分 |
| IrisHal | 硬件抽象层 | 驱动调用、帧率、超时 |
| CameraHal | 摄像头 HAL | 预览流、帧数据 |
调试时，你可以这样过滤：
adb logcat -s IrisService:I IrisHal:I BiometricService:I *:S这样只显示这三个 TAG 的信息，其他一概忽略。清爽很多。
IrisDaemon 或 FingerprintService（没错，他们混在一起了）。遇到这种情况，先 adb logcat | grep -i iris 扫一遍。
常见问题排查：我踩过的坑
做虹膜识别调试，有几个问题几乎每个人都会遇到。我列出来，你对照着看：
1. 识别按钮灰色，点不了
原因通常是：设备没有注册虹膜数据，或者系统认为当前环境不适合识别。你先去「设置-安全-生物识别」里看看，有没有录入过虹膜。如果没有，那肯定点不了。
2. 弹窗一闪而过，直接失败
这种情况，我遇到过两次。一次是因为 crypto 对象传错了，导致 CryptoObject 校验失败。另一次是因为 onAuthenticationError 里收到了 ERROR_LOCKOUT（尝试次数过多被锁了）。
排查方法：看 Log 里的 BiometricService 输出，它会告诉你具体的错误码。
3. 识别成功率低，时好时坏
这通常不是代码问题，而是硬件或环境问题。你可以试试：
- 擦一下摄像头镜头（真的，很多人忽略这个）
- 换个光线环境（别在强光直射下测）
- 检查用户是否戴了眼镜或美瞳（有些手机对眼镜支持不好）
4. 模拟器上正常，真机上崩溃
最常见的原因是：真机上缺少某些系统服务。比如 IrisManager 在某些低端机上可能返回 null。你代码里有没有做空指针判断？
// 安全写法
IrisManager manager = (IrisManager) context.getSystemService(Context.IRIS_SERVICE);
if (manager == null) {
// 当前设备不支持虹膜，直接降级
return;
}知识体系总览
下面这张图，是我自己整理的一套调试思路。你照着这个流程走，基本能覆盖 90% 的问题。
核心思路： 先确认环境，再验证权限，然后跑流程。出问题了，先看日志，别瞎猜。最后一定要在真机上回归一遍。模拟器只是辅助，别太依赖它。
好了，关于测试和调试，我就说这么多。你按这个流程走一遍，大部分问题都能自己搞定。如果还有搞不定的，欢迎来交流。
公众号:蓝海资料掘金营，微信deep3321