uni.checkFaceID 返回 false 或报错主因是环境不达标：需先调用 uni.checkIsSupportBiometrics 确认平台支持，iOS 需配置 manifest 和权限描述，Android 依赖厂商支持与系统级权限，H5 不支持，小程序须走支付 SDK 生物验证链路。
uni-app 调用 uni.checkFaceID 和 uni.checkIsSupportBiometrics 前必须确认平台支持
ios 和 android 在 uni-app 中的生物识别能力差异大，h5 完全不支持，微信小程序需额外配置且仅限支付场景。不先查支持性就调用 uni.checkfaceid，大概率直接报错或静默失败。
- iOS：真机可调用
uni.checkFaceID（对应 Face ID / Touch ID），但需在manifest.json中勾选「使用安全密钥」并配置NSFaceIDUsageDescription - Android：仅部分厂商（华为、小米、OPPO 等）系统级支持，且依赖
android.permission.USE_BIOMETRIC权限；uni.checkFaceID在多数安卓机上返回false或直接 reject - H5：所有生物识别 API 均不可用，调用会立刻失败，错误信息为
not supported - 微信小程序：不能直接调用设备生物识别，必须走
wx.requestPayment+ 后端统一下单 + 微信唤起指纹/面容，和 uni-app 自身 API 无关
为什么 uni.checkFaceID 总是返回 false 或报错 “biometric not available”
这不是代码写错了，而是环境没达标。这个函数只检查设备是否「当前可用」——它会综合判断：系统版本、硬件能力、用户是否开启生物识别、App 是否被授权、甚至是否锁屏中。
- 常见假阴性：用户刚重启手机但未录入指纹/面容，或设置里关闭了「iPhone 上的 Face ID」开关
- 开发阶段容易忽略：Android 模拟器默认不支持，真机调试时若未在系统设置中给 App 单独开启「生物识别权限」，也会返回 false
- uni-app 2.7+ 版本中，
uni.checkFaceID在 Android 上实际调用的是BiometricPrompt，要求 targetSdkVersion ≥ 29，否则可能 crash 或 fallback 失败 - 不要把它当「永久能力开关」缓存，每次调用前都应重新检查
生物识别不能直接用于支付，只能作为「身份确认环节」嵌入业务流程
uni-app 没有提供「调起支付+生物验证」的一体化接口。所谓「生物识别支付」，本质是：服务端生成支付凭证 → 客户端唤起支付 SDK（如支付宝/微信）→ 支付 SDK 内部触发生物验证 → 验证通过后完成扣款。uni-app 只能控制第一步和第三步之间的衔接。
- 你无法用
uni.checkFaceID直接扣款，也不能绕过支付通道自己签名交易 - 正确链路：用户点击「刷脸支付」→ 调用
uni.checkFaceID确认设备支持 → 成功后请求后端生成预支付订单（如微信unifiedorder）→ 拿到paySign后调用uni.requestPayment→ 微信/支付宝 SDK 自动唤起生物验证 - 若跳过
uni.checkFaceID直接进uni.requestPayment，用户仍可能在支付环节遇到生物验证失败，但此时已无法友好提示或降级
Android 上 uni.checkFaceID 的兼容性坑比想象中多
不是所有标称「支持指纹」的安卓机都能被 uni-app 正确识别。尤其在低版本系统（Android 8.0 以下）或定制 ROM（如早期 EMUI、MIUI）上，API 层级不一致导致行为分裂。
- 某些机型（如部分 Redmi）需要手动在「设置 → 密码与安全 → 指纹管理」中，为当前 App 单独开启「使用指纹」开关，否则
uni.checkFaceID返回 false - targetSdkVersion = 28 的项目，在 Android 10+ 设备上调用可能抛出
SecurityException，日志显示BiometricManager is not available - 避免用
uni.checkFaceID判断「是否允许登录」——它不等价于「用户已认证」，只是「设备此刻能验」；真正认证应由后端签发 token 控制 - 测试时务必覆盖：华为（EMUI）、小米（MIUI）、OPPO（ColorOS）、vivo（Funtouch OS）四大厂商主流机型，别只信模拟器
生物识别的「可用性」和「有效性」是两回事。设备说它能验，不代表用户愿意验、能验成功、或验完就能付款——中间每一步都得有 fallback（输密码、短信验证码），而且 fallback 的触发时机比你想的更早。
