Qt 6.10.0 Android平台TextField与TextInput键盘输入异常问题

阿华AIGC实验室

2026-4-1

遇到过一模一样的坑！我在Qt 6.10.0开发Android应用时也碰到了这个TextInput/TextField只能删除现有文本、无法输入新内容的诡异问题，折腾了好一会儿才摸清楚几个靠谱的解决思路，分享给你：

检查输入组件的inputMethodHints属性配置
有时候默认的输入提示可能和Android输入法的适配逻辑冲突，尝试显式设置更通用的hint值，避免触发输入法的特殊处理：
```
TextField {
    id: usernameInput
    inputMethodHints: Qt.ImhNoPredictiveText | Qt.ImhNoAutoUppercase
}
```
你可以根据输入场景调整hint组合，比如纯数字输入就用Qt.ImhDigitsOnly，核心是避免那些可能让输入法和Qt输入桥接逻辑“打架”的配置。
修复AndroidManifest.xml的软输入模式
窗口焦点处理异常也会导致输入事件丢失，打开项目的AndroidManifest.xml，给目标Activity添加软输入模式配置：
```
<activity
    android:name="org.qtproject.qt.android.bindings.QtActivity"
    android:windowSoftInputMode="adjustResize|stateUnchanged">
    
</activity>
```
adjustResize会让窗口在键盘弹出时自动调整大小，确保输入组件始终处于可交互状态；stateUnchanged则保持键盘的显示状态稳定，减少焦点切换的异常。
强制输入组件获取焦点
有时候输入组件的焦点状态没有正确绑定，导致输入法的输入信号无法传递到组件。可以在初始化和点击时主动强制获取焦点：
```
TextInput {
    id: contentInput
    Component.onCompleted: contentInput.forceActiveFocus(Qt.MouseFocusReason)
    onPressed: contentInput.forceActiveFocus(Qt.MouseFocusReason)
}
```
明确指定MouseFocusReason能让组件准确响应点击触发的焦点请求，避免焦点“跑偏”。
排查事件拦截问题
检查输入组件的上层或父容器，有没有透明的MouseArea、Item等组件意外拦截了输入事件。比如如果有一个覆盖整个页面的透明MouseArea用于全局点击，它可能会吃掉输入法的输入信号。可以暂时注释掉这类组件，测试输入是否恢复正常，再针对性调整事件过滤逻辑。
尝试切换输入法或降级Qt版本
部分第三方输入法（比如某些带AI联想的输入法）和Qt 6.10.0的输入适配存在兼容性问题，切换到Android原生输入法测试，如果恢复正常，那可以考虑在应用中添加适配提示。如果所有办法都无效，暂时降级到Qt 6.9.2也是一个可行的临时方案——这个版本的Android输入逻辑我测试过，是稳定的。