You need to enable JavaScript to run this app. Chrome84+基于WebOTP API实现OTP自动检测抛出OTP检索取消的DOMException异常
优惠活动
大模型
产品
解决方案
定价
更多

Chrome84+基于WebOTP API实现OTP自动检测抛出OTP检索取消的DOMException异常

WebOTP API 抛出「DOMException: OTP retrieval was cancelled」异常排查

该异常的核心触发原因是WebOTP的获取请求在唤起短信授权弹窗前就被主动中止,未进入正常的短信识别等待流程,结合常见开发场景,可按以下方向排查修复:

常见触发场景

  • AbortController 被提前触发中止逻辑
    这是最高发的场景:开发人员在参考示例代码时,常会把 ac.abort() 绑定在组件卸载清理、路由跳转守卫、React StrictMode 的effect清理逻辑中,甚至在同步代码里提前调用abort,导致刚发起 navigator.credentials.get 请求就被直接取消,完全等不到授权弹窗。尤其在React 18的开发环境下,StrictMode会自动执行effect的清理逻辑,极易导致刚发起的WebOTP请求被立刻中止。
  • 运行环境不符合WebOTP的调用要求
    WebOTP API 仅在安全上下文下可用:生产环境必须配置有效证书的HTTPS地址,仅localhost调试场景可豁免HTTPS要求;如果页面嵌套在跨域iframe中,调用权限会被直接拦截,最终抛出请求被取消的异常,不会弹出其他权限提示。
  • 调用时机被Chrome静默拦截
    Chrome 84+版本要求WebOTP请求必须绑定用户主动交互的触发上下文,如果在页面加载完成后、无任何用户点击/输入交互的场景下直接静默调用获取接口,Chrome会出于反滥用机制直接取消请求,不弹出授权提示。
  • 浏览器功能开关被禁用
    如果用户手动在Chrome设置中关闭了“自动填充验证码”功能,或者所在企业通过组策略强制禁用了WebOTP能力,Chrome同样不会弹出权限提示,直接抛出请求被取消的异常。

对应修复方案

  • 梳理所有AbortController的触发链路
    检查所有调用ac.abort()的代码位置,确认abort逻辑仅在OTP获取流程结束(成功/失败)、用户主动取消验证操作、离开验证页面时才执行,避免在请求发起后的同步链路、组件初始挂载的清理逻辑中提前触发中止。
  • 校验运行环境合规性
    确认生产环境使用受信任CA签发的HTTPS证书,不要在跨域嵌套的iframe页面中调用WebOTP接口,本地调试时使用localhost域名避免安全上下文校验失败。
  • 调整请求触发时机
    将WebOTP的获取请求绑定在用户主动操作的回调中,比如用户点击“获取验证码”按钮、OTP输入框获得焦点的事件逻辑里,不要在页面初始化的同步逻辑中无交互发起请求。
  • 确认浏览器功能状态
    引导受影响用户在Chrome自动填充设置中,确认“自动填充验证码”的开关处于开启状态,排除企业策略的强制限制。

内容的提问来源于stack exchange,提问作者WanaveSurekha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 03:27:04