WebAuthn在一加设备上无法注册/验证问题求助

问题概述 #

WebAuthn跨设备注册/验证流程中，除一加设备外其余移动设备均可正常通过扫码完成操作，但一加设备（Android 13的OnePlus Nord、Android 14的OnePlus 7）在扫码后，设备显示指纹验证界面，网页端却出现超时或操作取消提示，预期应为等待指纹/密码验证并返回对应结果。推测问题与Google Play服务或OxygenOS的指纹认证机制相关，且在webauthn.io上已复现该异常。

排查与解决步骤 #

1. 检查并修复Google Play服务状态 #

一加设备的WebAuthn依赖Google Play服务处理安全认证流程，版本异常或缓存问题可能导致交互中断：

• 进入「设置-应用- Google Play服务」查看版本，对比同系统正常设备的版本，更新至最新稳定版；
• 清除Google Play服务的缓存与数据（「设置-应用- Google Play服务-存储-清除缓存/清除数据」），重启设备后重试。

2. 调整OxygenOS生物识别相关配置 #

OxygenOS的指纹模块附加设置可能干扰WebAuthn流程：

• 确认指纹已正常录入并设为默认解锁方式（「设置-安全与隐私-指纹」）；
• 给扫码应用、浏览器开启生物识别权限（「设置-应用-对应应用-权限-生物识别」）；
• 关闭「指纹快捷操作」「指纹动画」等附加功能，减少流程干扰。

3. 优化WebAuthn请求参数（针对自有Web应用） #

针对一加设备的特性调整请求参数，适配其认证耗时：

• 延长timeout参数：将注册/验证请求中的timeout从默认60秒调整至90秒，给指纹认证留出足够处理时间；
• 调整authenticatorSelection配置：若设置了residentKey: required，尝试改为preferred或discouraged，避免一加设备的存储适配问题；
• 放宽userVerification要求：若设为required，改为preferred，允许设备 fallback 到密码验证，排查是否为指纹交互的专属问题。

4. 测试不同扫码与浏览器组合 #

排除第三方工具的兼容性问题：

• 使用一加自带扫码工具替代Google扫码，避免第三方应用的适配缺陷；
• 切换Chrome、Firefox等不同浏览器打开webauthn.io测试，排查浏览器自身的适配问题；
• 直接在一加设备上进行WebAuthn本地注册（非跨设备扫码），验证设备本身的WebAuthn功能是否正常，区分是跨设备流程还是本地认证的问题。

5. 系统层面的修复尝试 #

• 安装设备的最新OxygenOS系统更新，小版本更新常修复生物识别与WebAuthn的交互bug；
• 删除已录入的指纹并重新录入，排除指纹数据异常导致的认证中断；
• 若有条件，测试同型号设备的不同OxygenOS版本，确认是否为特定版本的系统问题。

内容的提问来源于stack exchange，提问作者Lokesh