Flutter iOS 如何隐藏/移除键盘上残留的“来自信息”OTP建议
即时移除iOS端残留短信OTP键盘建议的可落地方案
问题本质
iOS系统的短信OTP键盘建议属于系统级行为,并非由Flutter输入框的enableSuggestions、autocorrect参数完全控制。只要应用触发过一次系统OTP读取流程,系统会在当前会话内所有带数字键盘的输入框上缓存该建议值,直到系统自身的3-4分钟过期计时走完。
目前已验证常规的输入框参数配置、切换焦点重唤键盘的操作都无法触发系统的建议缓存清除,Stepper组件的多步骤同页面结构,会进一步延长这个缓存的复用范围,导致后续所有数字输入框上都会一直显示已使用过的OTP建议。
可直接落地的解决方法
- 通过输入框通道配置阻断系统OTP注入
手机号输入步骤完成后,给后续所有数字类输入框添加空的内容插入允许列表,从输入通道层面切断系统OTP建议的推送路径,示例配置:TextField( keyboardType: const TextInputType.numberWithOptions(decimal: false, signed: false), enableSuggestions: false, autocorrect: false, contentInsertionConfiguration: ContentInsertionConfiguration( allowedMimeTypes: const <String>[], // 空列表直接阻断系统OTP插入通道 onContentInserted: (_) {}, ), ) - 通过原生通道强制刷新键盘辅助栏
当手机号验证步骤完成、Stepper切换到下一个步骤时,通过Method Channel调用iOS原生端能力,主动清除当前应用会话的OTP建议缓存:原生端核心逻辑:获取当前应用的
UIInputAssistantItem实例,开启系统的辅助栏隐藏属性,将栏位的按钮组重置为空数组,强制刷新键盘的辅助建议栏渲染。 - 临时切换键盘类型触发系统全量重载
验证步骤完成后,不要直接把焦点切到下一个同类型数字输入框:- 先将当前获得焦点的输入框临时设置为
keyboardType: TextInputType.text,让键盘完成一次全量重载 - 间隔100毫秒后,再把目标输入框的键盘类型改回需要的数字键盘类型
该操作会让系统判定当前的OTP建议已经不属于当前输入场景的适配内容,不会再在新的输入框上复用之前缓存的验证码建议。
- 先将当前获得焦点的输入框临时设置为
避坑提示
- 禁止用
keyboardType: TextInputType.visiblePassword替代数字键盘,该类型虽然能阻断OTP建议,但会触发密码输入框的自动填充逻辑,和数字输入场景不匹配 - 单独设置
enableSuggestions: false参数无法覆盖系统级OTP建议的缓存逻辑,必须配合输入通道阻断配置才能生效 - 该问题并非Stepper组件本身导致,本质是Stepper的所有步骤输入框同属一个页面上下文,系统会在整个页面生命周期内复用OTP建议缓存
内容的提问来源于stack exchange,提问作者Karen
相关产品推荐
相关产品推荐

