uni.checkFaceID 返回 false 是因设备当前不满足调用条件，非代码错误；需按平台配置权限、系统设置及 SDK 版本要求。
uni.checkFaceID 为什么总是返回 false
这不是代码写错了，而是设备当前不满足调用条件。这个函数只检查「此刻是否可用」，不是永久能力开关。
- iOS 真机需先在
manifest.json勾选「使用安全密钥」，并配置NSFaceIDUsageDescription；未配置时直接报错或静默失败 - Android 大部分机型返回
false：厂商系统级支持不统一（华为/小米/OPPO 部分型号可用），且必须声明android.permission.USE_BIOMETRIC权限并手动在系统设置里给 App 开启生物识别授权 - Android 模拟器默认不支持；真机调试时若用户没录入指纹/面容、或锁屏状态、或系统设置里关闭了生物识别开关，都会触发
false -
uni-app 2.7+ 要求 targetSdkVersion ≥ 29，否则
uni.checkFaceID在 Android 上可能 crash 或 fallback 失败
uni.startSoterAuthentication 是不是能直接刷脸支付
不能。它只是启动设备本地生物认证流程，和支付无直接关系，也不触达微信/支付宝等支付通道。
-
uni.startSoterAuthentication对应的是 Soter 安全框架，用于生成加密签名或校验设备可信状态，常用于登录、敏感操作二次确认 - 它不生成支付凭证，不唤起支付 SDK，也不能替代
uni.requestPayment或微信原生插件的facepay方法 - 如果你要实现“刷脸后扣款”，必须走两段式：先用
uni.startSoterAuthentication或uni.checkFaceID做身份确认 → 再请求后端下发预支付参数 → 最后调用对应平台的支付唤起接口 - 注意：Soter 在 iOS 上支持 Face ID / Touch ID，在 Android 上依赖厂商适配，很多中低端机仅返回
authState: "failed"
微信刷脸支付在 uni-app 中只能走原生插件
H5 和小程序端完全无法调用设备摄像头做刷脸支付；App 端必须用原生插件封装微信 wxpayface SDK，不能靠 JS 实现。
- 微信刷脸支付（
wxfacepay）要求使用专用硬件（如青蛙 Pro），且商户号必须开通「刷脸支付」权限并绑定设备 SN 码 - 前端不能自己采集人脸图像上传——所有活体检测、3D 结构光比对、与微信支付服务器交互都由原生 SDK 完成
- 典型调用链：
facepayplugin.init()→ 用户点击支付 →facepayplugin.startpayment({orderid, totalfee})→ 插件内部完成全流程并回调结果 - 务必在
manifest.json的app-plus.plugins下声明插件，并在permission中添加scope.camera；iOS 还需补全NSCameraUsageDescription
支付宝人脸识别在 uni-app 中怎么接入
支付宝小程序端可用官方 my.faceVerify API，但 uni-app 编译为支付宝小程序时，需用条件编译 + 原生组件封装，不能直接在 H5 或 App 端复用。
- App 端（iOS/Android）无法调用支付宝的人脸识别能力——因为那是支付宝小程序容器内的专属接口，uni-app App 环境没有该运行上下文
- 只有编译目标为
mp-alipay时，才能在页面中使用my.faceVerify，且需提前在支付宝开放平台开通「人脸识别」权限并获取 RSA2 私钥 - manifest.json 中必须配置：
"mp-alipay": { "permission": [{ "scope": "scope.camera", "desc": "需要摄像头权限进行人脸识别" }] - 不要试图把支付宝人脸 SDK 打包进 uni-app App 端——既违反支付宝平台规范，也无法通过审核
最容易被忽略的一点：生物识别本身不等于支付。所有“刷脸支付”最终都必须经过支付通道的订单校验与资金划转，设备端的生物验证只是其中一环。跳过服务端预下单、硬编码金额、或把 uni.checkFaceID 当作支付成功信号，是线上事故高发区。
