人脸支付零计数误拦截修复记录

现象

开启人脸支付并完成启动页全量同步后，在结算页点击人脸支付仍提示“本机尚未加载可识别的人脸数据，请先同步人员”。

诊断证据

• 当前测试终端人员表共 1844 条，其中 1178 条含人脸特征；人脸库 user 表共 1178 条。
• 终端日志显示百度 FaceSearch 已成功推送本地特征。
• 该提示只由会话收到运行时缓存人数小于等于 0 时触发。

因此终端并非没有同步人脸数据，而是运行时人数缓存与真实人脸数据短暂不一致，造成误判。

修复

• FaceRecognitionSessionStartupPolicy.java：首次零计数先刷新索引，刷新后仍为空才报告无数据，有效人数直接启动摄像头。
• FaceRecognitionRuntime.java：索引刷新增加可取消的完成/失败回调，返回最终一轮刷新后的真实人数。
• FaceRecognitionSession.java：零计数时自动重建本地 1:N 索引，刷新成功后继续识别。
• FaceRecognitionSessionStartupPolicyTest.java：覆盖零计数自愈和真实空库分支。

验证

• TDD 红灯：策略类不存在时编译失败；实现后定向测试通过。
• JDK 8 执行 :app:testDebugUnitTest :app:assembleDebug：BUILD SUCCESSFUL。
• 15 个测试套件共 46 个测试，失败和错误均为 0。
• git diff --check 通过，Debug APK 已生成。

真机验收

安装新 APK 后，在当前已有 1178 条人脸数据的终端再次点击人脸支付：首次检测到缓存零计数时应自动刷新索引，随后进入摄像头识别，不再误提示同步人员。

本次未安装 APK 到终端，也未执行 Git 暂存、提交、推送、分支切换或清理。