无法捕获返回键致键盘状态异常：ImeInputStage输入已完成

问题根源 #

你手动维护的keyboardOpened变量依赖于toggleSoftInput方法的调用，但当返回键关闭键盘时，系统在ImeInputStage层级就处理了事件，Activity的按键回调（dispatchKeyEvent、onKeyDown等）无法拦截，导致变量无法同步更新。

解决方案：监听软键盘状态变化 #

放弃手动维护状态，通过监听布局变化间接判断键盘的显示/隐藏状态，这种方式能覆盖所有键盘状态变更场景（包括返回键关闭键盘）。

具体实现步骤 #

1. 注册布局全局监听，通过根布局的可见区域变化判断键盘状态
2. 在监听中计算屏幕高度与布局可见高度的差值，超过阈值则判定键盘打开
3. 同步更新keyboardOpened变量
4. 在Activity销毁时移除监听，避免内存泄漏

代码示例 #

public class MainActivity extends AppCompatActivity {
    private boolean keyboardOpened = false;
    private ViewTreeObserver.OnGlobalLayoutListener keyboardLayoutListener;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        final View rootView = findViewById(android.R.id.content);
        keyboardLayoutListener = () -> {
            Rect visibleFrame = new Rect();
            rootView.getWindowVisibleDisplayFrame(visibleFrame);
            int screenHeight = rootView.getRootView().getHeight();
            int keyboardHeight = screenHeight - visibleFrame.bottom;

            // 用200dp作为键盘显示的阈值，适配不同屏幕
            int threshold = dpToPx(200);
            boolean isKeyboardCurrentlyOpen = keyboardHeight > threshold;

            if (isKeyboardCurrentlyOpen != keyboardOpened) {
                keyboardOpened = isKeyboardCurrentlyOpen;
                // 这里可以添加键盘状态变化后的业务逻辑
                Log.d("KeyboardState", "键盘状态变更：" + (keyboardOpened ? "打开" : "关闭"));
            }
        };

        rootView.getViewTreeObserver().addOnGlobalLayoutListener(keyboardLayoutListener);
    }

    private int dpToPx(int dp) {
        return (int) (dp * getResources().getDisplayMetrics().density);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        View rootView = findViewById(android.R.id.content);
        if (keyboardLayoutListener != null) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
                rootView.getViewTreeObserver().removeOnGlobalLayoutListener(keyboardLayoutListener);
            } else {
                rootView.getViewTreeObserver().removeGlobalOnLayoutListener(keyboardLayoutListener);
            }
        }
    }

    public void toggleSoftInput() {
        InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.toggleSoftInput(InputMethodManager.SHOW_IMPLICIT, InputMethodManager.HIDE_IMPLICIT_ONLY);
        // 无需手动翻转keyboardOpened，监听会自动同步状态
    }
}

说明 #

• 布局监听的原理：软键盘弹出时会压缩Activity的布局，导致根布局的可见区域高度变小，通过计算差值可以准确判断键盘是否显示
• 阈值设为200dp是因为大多数设备的软键盘高度都超过这个值，你可以根据需求调整
• 这种方式不受键盘关闭方式影响，不管是返回键、点击空白处还是代码控制，都能准确同步状态

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