Flutter Android端键盘异常：点击输入控件显示白框而非键盘

以下是几个常见的排查和解决方向：

• 检查AndroidManifest.xml的软键盘模式配置
  打开android/app/src/main/AndroidManifest.xml，找到主Activity标签，确保android:windowSoftInputMode设置为合理的值，比如adjustResize或adjustPan，避免设置为adjustNothing。示例配置：

  <activity
      android:name=".MainActivity"
      android:windowSoftInputMode="adjustResize">
  

• 排查第三方插件冲突
  如果项目中使用了键盘相关的第三方插件（如flutter_keyboard_visibility），尝试暂时移除该插件并重新运行项目，确认是否是插件逻辑拦截了键盘弹出。

• 检查Android主题设置
  打开android/app/src/main/res/values/styles.xml，确保AppTheme的父主题是Flutter兼容的标准主题，比如Theme.MaterialComponents.DayNight.NoActionBar，避免自定义主题覆盖键盘的默认显示逻辑：

  <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
      <!-- 其他自定义属性 -->
  </style>
  

• 清理项目缓存并重建
  执行以下命令清理缓存后重新编译：

  flutter clean
  flutter pub get
  

  也可以在Android Studio中执行Build -> Clean Project，再选择Rebuild Project。

• 检查设备/模拟器输入法设置

  • 实体设备：切换到系统默认输入法，确认第三方输入法是否出现崩溃或异常。
  • 模拟器：关闭Hardware Keyboard模拟选项（可在模拟器的Settings -> System -> Languages & input -> Physical keyboard中设置），避免硬件键盘拦截软键盘弹出。

内容的提问来源于stack exchange，提问作者Moaz El-sawaf