uni-app 中指纹识别需用 uni.startSoterAuthentication，它跨平台调用系统生物认证，不支持纯指纹强制模式，须兼容 faceID/指纹双模式、正确处理 challenge、authContent、resultJSON 解码及 authMode 平台差异。
uni-app里调用指纹识别，得用 uni.startSoterAuthentication
直接上结论：uni-app 没有封装独立的“指纹识别” API，uni.startSoterAuthentication 是目前唯一官方支持、跨平台（App + 微信小程序）且能稳定触发指纹/人脸识别的接口。它底层调用的是 iOS 的 LocalAuthentication 和 Android 的 BiometricPrompt，不是自己实现算法，所以不涉及活体检测或人脸比对逻辑——它只做“设备级生物凭证验证”，验证通过后返回签名结果。
为什么不能只传 fingerPrint 就一定能走指纹？
因为实际行为由设备能力、系统设置和运行时环境共同决定：
-
requestAuthModes: ['fingerPrint']只是“请求偏好”，系统可能忽略它——比如 iPhone 上用户只设置了 Face ID，即使你指定fingerPrint，也会 fallback 到 Face ID；Android 设备若未录入指纹或禁用了生物认证，会直接失败 - 微信小程序中，
fingerPrint仅在安卓真机生效，iOS 微信不支持指纹，强制走 Face ID（如果可用） - App 端（iOS）必须在
manifest.json中配置NSFaceIDUsageDescription，否则 Face ID 调用直接 crash；Android 需确保uses-permission包含android.permission.USE_BIOMETRIC - 部分国产安卓机型（如华为 EMUI 11 以下、小米 MIUI 12 早期版本）对
requestAuthModes参数识别不一致，建议始终传['fingerPrint', 'facial']双模式兜底
uni.startSoterAuthentication 的关键参数怎么填才不出错？
最容易翻车的是 challenge 和 authContent：
-
challenge必须是非空字符串，且建议每次调用都生成唯一值（如时间戳+随机数），不能写死。它是服务端验签的关键输入，如果前后端 challenge 不一致，签名验证就失效 -
authContent在 iOS 上是必显文案（如“请验证指纹以登录”），在 Android 上部分厂商会忽略；留空会导致 iOS 弹窗无提示，用户不知道要干什么 -
success回调里的resultJSON是 base64 编码的 JSON 字符串，需在服务端JSON.parse(atob(resultJSON))解析，里面包含rawData（签名原文）、signature（签名值）、signedChallenge（服务端需校验是否等于你传入的 challenge） - 不要在
fail回调里直接重试——用户连续失败 3 次后，iOS 会锁死生物认证 60 秒，Android 也可能触发系统级限制
App 和微信小程序的返回结构差异必须处理
同一个 API，在不同平台返回字段不一致，硬编码取值会崩溃：
- iOS App 返回
res.authMode === 'touch'（不是'fingerPrint'）；Android App 才是'fingerPrint'；微信小程序安卓返回'fingerPrint'，iOS 微信返回'facial'（即使你没传facial） -
resultJSON在微信小程序中是完整对象，App 端（尤其是旧版 HBuilderX）可能为空字符串或缺失，需加判空：if (res.resultJSON && typeof res.resultJSON === 'string') - 错误码不统一：App 端常见
errCode: -1（用户取消）、-2（硬件不可用）；微信小程序是errCode: 10004（用户拒绝）、10007（系统未开启生物认证）——不能靠数字硬判断，要用errMsg做 fallback 提示
真实项目里最常被忽略的点：没做 resultJSON 的 base64 解码兼容性处理，也没对 authMode 做平台归一化映射，导致同一套验签逻辑在 iOS App 和微信小程序上表现不一致。
