Android阻止软键盘弹出：物理键盘回车跳转后EditText首次输入仍弹出

问题分析 #

物理键盘回车键跳转页面时，系统可能因事件传递残留或页面焦点初始化时机问题，绕过setShowSoftInputOnFocus(false)的设置，导致首次输入时软键盘弹出。而屏幕按钮跳转无此问题，是因为事件触发流程更符合预期，无额外的系统软键盘唤起逻辑。

系统性解决方案 #

1. 全局Style层面配置（优先推荐，无硬编码） #

在自定义的EditTextStyle中添加软键盘禁用属性，确保所有使用该Style的EditText默认获焦时不弹出软键盘：

<!-- styles.xml 中你的自定义EditTextStyle -->
<style name="CustomEditTextStyle" parent="Widget.AppCompat.EditText">
    <!-- 其他自定义属性 -->
    <item name="android:showSoftInputOnFocus">false</item>
</style>

此方式无需在每个EditText中单独设置，属于全局系统性配置，覆盖所有场景的基础行为。

2. 基类Activity统一处理软键盘 #

创建BaseActivity作为所有Activity的父类，在其中实现通用的软键盘控制逻辑，避免重复代码：

public class BaseActivity extends AppCompatActivity {
    @Override
    protected void onResume() {
        super.onResume();
        disableSoftKeyboardForFocusedView();
    }

    private void disableSoftKeyboardForFocusedView() {
        View focusedView = getCurrentFocus();
        if (focusedView instanceof EditText) {
            EditText editText = (EditText) focusedView;
            // 确保获焦时不唤起软键盘
            editText.setShowSoftInputOnFocus(false);
            // 强制隐藏已弹出的软键盘（处理物理跳转后的异常唤起）
            InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
            imm.hideSoftInputFromWindow(focusedView.getWindowToken(), 0);
        }
    }
}

所有需要该逻辑的Activity继承BaseActivity即可，实现跨页面的统一控制。

3. 正确消费源页面的物理回车事件 #

在触发跳转的源页面EditText中，完全消费回车事件，避免系统将事件传递到新页面引发异常：

EditText sourceEditText = findViewById(R.id.source_edit_text);
sourceEditText.setOnKeyListener((v, keyCode, event) -> {
    // 仅处理回车抬起事件
    if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_UP) {
        // 执行页面跳转
        startActivity(new Intent(this, TargetActivity.class));
        // 消费事件，阻止系统后续处理
        return true;
    }
    return false;
});

4. 高版本系统增强控制（API 30+） #

针对Android 11及以上版本，使用WindowInsetsController替代传统的InputMethodManager，控制更可靠：

// 在目标Activity的onCreate中添加
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    WindowInsetsController insetsController = getWindow().getInsetsController();
    if (insetsController != null) {
        // 立即隐藏软键盘
        insetsController.hide(WindowInsets.Type.ime());
        // 设置系统栏行为，禁止自动弹出软键盘
        insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
    }
}

验证逻辑 #

1. 应用全局Style配置后，所有EditText默认获焦不弹软键盘；
2. 基类Activity的onResume处理确保页面跳转后无论触发方式，都能修正焦点后的软键盘状态；
3. 消费回车事件避免了物理按键引发的系统异常逻辑；
4. 高版本API增强控制覆盖系统层级的软键盘唤起逻辑。

内容的提问来源于stack exchange，提问作者らむね