Android主窗口无焦点致EditText与onBackPressed异常排查

问题梳理 #

• EditText显示光标（视图已获焦）但无法唤起软键盘，手动调用InputMethodManager.showSoftInput()返回false，editText.hasWindowFocus()返回false
• 所有Activity的onBackPressed()完全不触发，不受返回事件来源（物理按键/手势）、系统栏状态影响
• 排查情况：无全局代码变更、回退targetSdk至31后问题依旧、多台平板均出现该问题、Manifest配置无异常

窗口失焦常见原因 #

• 全局悬浮组件抢占焦点：应用内的Dialog、PopupWindow，或第三方悬浮窗组件，若设置了焦点属性，会直接抢占Activity窗口的焦点。
• Window标记配置错误：Activity窗口被添加了FLAG_NOT_FOCUSABLE或FLAG_ALT_FOCUSABLE_IM标记，这类标记会剥夺窗口获取焦点的能力。
• 多窗口/分屏模式影响：平板设备的多窗口、分屏状态下，系统可能将焦点分配给其他窗口，导致当前Activity窗口失焦。
• 第三方库或系统服务干扰：全局UI库、输入法SDK，或者系统辅助功能服务，可能暗中修改窗口焦点状态。
• 主题配置异常：自定义主题继承时遗漏了焦点相关属性，或错误设置了影响窗口焦点的主题参数。

手动设置窗口焦点的解决方案 #

清除窗口非焦点标记并强制请求焦点 #

在Activity的onCreate()或onResume()中添加以下代码：

// 清除阻止窗口获焦的标记
getWindow().clearFlags(WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE | WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM);
// 设置软键盘默认显示
getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE);
// 强制请求DecorView获取焦点
getWindow().getDecorView().requestFocus();

排查并关闭抢占焦点的组件 #

• 检查应用内所有Dialog、PopupWindow，确保不需要焦点时设置setFocusable(false)，且使用完毕后及时dismiss()；
• 暂时禁用第三方悬浮窗权限，测试是否恢复正常。

监听窗口焦点变化并处理 #

在Activity中添加焦点监听器，及时处理焦点状态：

getWindow().getDecorView().setOnWindowFocusChangeListener((hasFocus) -> {
    if (hasFocus) {
        // 窗口获焦后，尝试唤起软键盘
        InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.showSoftInput(getCurrentFocus(), InputMethodManager.SHOW_IMPLICIT);
    }
});

调整多窗口配置（针对平板） #

在Manifest的Activity标签中添加或修改：

android:resizeableActivity="false"

若需要支持多窗口，可在onConfigurationChanged()中补充焦点处理逻辑。

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