Flutter点击TextField时设备键盘未弹出问题求助

问题引发原因 #

你提供的代码中TextField的onTap回调可以正常打印日志，说明组件点击事件没有被上层拦截，该问题的常见触发原因如下：

• 测试用的模拟器/实体设备开启了硬件键盘优先设置，系统优先响应硬件输入，不会主动弹出软键盘
• 页面或全局逻辑中手动调用过隐藏软键盘的方法（如SystemChannels.textInput.invokeMethod('TextInput.hide')）后未恢复输入能力，导致TextField获取焦点后无法唤起软键盘
• 项目的全局焦点管理逻辑错误拦截了当前TextField的焦点获取请求
• 部分旧版Flutter SDK存在嵌套布局下焦点传递异常的已知bug，会导致TextField获取焦点后无响应

解决方案 #

可按优先级依次尝试以下方案：

1. 检查测试环境配置
   若使用安卓模拟器测试，进入设置 > 系统 > 语言和输入法 > 物理键盘，关闭「使用物理键盘」开关；若使用iOS模拟器，点击顶部菜单I/O > Keyboard > Connect Hardware Keyboard取消勾选，配置完成后重新点击TextField测试。
2. 手动绑定焦点节点触发唤起
   给TextField绑定独立的FocusNode，点击时主动请求焦点：

   // 页面state中声明FocusNode
   final FocusNode _titleFieldFocus = FocusNode();
   
   // 修改TextField配置
   TextField(
     focusNode: _titleFieldFocus,
     onTap: (){
       print("PULSAdo");
       // 主动请求焦点
       _titleFieldFocus.requestFocus();
     },
     controller: _controller,
     decoration: InputDecoration(
       hintText: 'Escribe aquí el título del evento',
       border: InputBorder.none,
       prefixIcon: Icon(Icons.edit),
     ),
   )
   

3. 排查全局软键盘控制逻辑
   检查当前页面及上层路由的代码，是否存在点击空白区域全局隐藏软键盘的逻辑，如果有需要新增判断，点击区域为TextField时不触发隐藏逻辑，避免TextField刚获取焦点就被强制隐藏软键盘。
4. 兼容低版本SDK异常
   以上方案都无效的话，可以手动调用方法唤起软键盘，代码如下：

   import 'package:flutter/services.dart';
   
   // 修改TextField的onTap回调
   onTap: (){
     print("PULSAdo");
     _titleFieldFocus.requestFocus();
     // 强制唤起软键盘
     SystemChannels.textInput.invokeMethod('TextInput.show');
   },
   

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