Android特定Fragment中EditText被软键盘遮挡 设置adjustResize不生效如何解决

失效原因 #

• 软键盘模式设置时机错误：onCreate/onCreateView阶段Fragment尚未完成和Activity的附着，配置不会生效
• 未做状态还原：如果不在Fragment离开时恢复Activity原有软键盘配置，会导致其他Fragment也继承该调整行为
• 布局缺少必要属性：未配置fitsSystemWindows的情况下，adjustResize模式不会触发布局重绘

实现步骤 #

1. 生命周期内动态配置软键盘模式 #

在Fragment中声明变量存储Activity原有软键盘配置，在可见时修改，离开时还原：

// 声明变量存储原有软键盘模式
private var originalSoftInputMode: Int = 0

override fun onResume() {
    super.onResume()
    // 保存Activity原有配置
    originalSoftInputMode = requireActivity().window.attributes.softInputMode
    // 设置当前Fragment需要的适配模式
    requireActivity().window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)
}

override fun onPause() {
    super.onPause()
    // 恢复原有配置，不影响同Activity下其他Fragment
    requireActivity().window.setSoftInputMode(originalSoftInputMode)
}

Java版本实现：

private int originalSoftInputMode = 0;

@Override
public void onResume() {
    super.onResume();
    originalSoftInputMode = requireActivity().getWindow().getAttributes().softInputMode;
    requireActivity().getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
}

@Override
public void onPause() {
    super.onPause();
    requireActivity().getWindow().setSoftInputMode(originalSoftInputMode);
}

2. 配置布局属性 #

在当前Fragment的布局根节点添加android:fitsSystemWindows="true"属性，确保系统窗口变化时布局会触发重绘：

<!-- Fragment根布局示例 -->
<androidx.core.widget.NestedScrollView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <!-- 内部包含所有EditText的布局 -->

</androidx.core.widget.NestedScrollView>

建议用NestedScrollView或ScrollView包裹所有输入项，确保输入项有足够的滚动空间适配软键盘高度

3. 特殊场景兼容 #

如果当前Activity使用了沉浸式/全屏模式，需要给Activity窗口添加如下配置确保adjustResize生效：

// 仅需在Activity onCreate中设置一次即可
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
window.clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)

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