BottomSheetDialogFragment被软键盘遮挡，SO方案均无效，求当前解决办法

我太懂这种挫败感了——翻遍SO相关问题、试遍各种方案还是卡壳，尤其是API更新后旧方法失效的情况，真的头疼！针对BottomSheetDialogFragment被软键盘遮挡的问题，我整理了几个当前有效的解决思路，你可以逐个试试：

1. 给Dialog单独设置软键盘调整模式 #

Activity的windowSoftInputMode有时候对Dialog不生效，得在BottomSheetDialogFragment的onCreateDialog里直接给Dialog的窗口配置：

Kotlin 代码示例： #

override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
    val dialog = super.onCreateDialog(savedInstanceState)
    dialog.window?.apply {
        // 关键：设置为adjustResize，让窗口随软键盘调整大小
        setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE or WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE)
    }
    return dialog
}

Java 代码示例： #

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
    Dialog dialog = super.onCreateDialog(savedInstanceState);
    if (dialog.getWindow() != null) {
        dialog.getWindow().setSoftInputMode(
            WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE
        );
    }
    return dialog;
}

2. 用滚动容器包裹BottomSheet内容 #

如果你的BottomSheet里有多个EditText和组件，一定要把布局根节点换成NestedScrollView或ScrollView。这样当软键盘弹出时，布局可以滚动，避免底部组件被遮挡。比如：

<androidx.core.widget.NestedScrollView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <!-- 你的EditText和其他组件放在这里 -->

</androidx.core.widget.NestedScrollView>

3. Android 11+ 手动处理窗口Insets #

API 30（Android 11）之后，系统对窗口Insets的处理有变化，有时候adjustResize不会自动生效，这时候可以手动监听输入法的inset，给布局添加底部padding：

Kotlin 代码示例： #

override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
    val dialog = super.onCreateDialog(savedInstanceState)
    dialog.window?.apply {
        setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)
        // 关闭系统自动适配，手动处理insets
        setDecorFitsSystemWindows(false)
        decorView.setOnApplyWindowInsetsListener { view, insets ->
            val insetsCompat = WindowInsetsCompat.toWindowInsetsCompat(insets)
            // 获取输入法的底部偏移量
            val imeBottom = insetsCompat.getInsets(WindowInsetsCompat.Type.ime()).bottom
            // 给根布局设置底部padding
            view.rootView.setPadding(0, 0, 0, imeBottom)
            // 返回处理后的insets
            insetsCompat.toWindowInsets()
        }
    }
    return dialog
}

4. 调整BottomSheetBehavior的配置 #

有时候BottomSheet的行为设置会影响软键盘适配，你可以强制让BottomSheet展开并自适应内容：

Kotlin 代码示例： #

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val bottomSheet = dialog?.findViewById<View>(com.google.android.material.R.id.design_bottom_sheet)
    bottomSheet?.let {
        val behavior = BottomSheetBehavior.from(it)
        // 让BottomSheet自适应内容高度
        behavior.isFitToContents = true
        // 强制BottomSheet展开（可选，根据你的需求）
        behavior.state = BottomSheetBehavior.STATE_EXPANDED
    }
}

5. 避免使用全屏主题 #

如果你的BottomSheetDialogFragment用了自定义的全屏主题，adjustResize可能完全失效。确保Dialog的主题是Material组件提供的默认BottomSheet主题，比如在AndroidManifest里给对应的Fragment设置：

<activity
    android:name=".YourActivity"
    ...>
    <fragment
        android:name=".YourBottomSheetDialogFragment"
        android:theme="@style/Theme.MaterialComponents.Light.BottomSheetDialog"
        ... />
</activity>

先从第1、2步开始试，这两个是最基础也最容易生效的。如果是Android 11以上的设备，再加上第3步的手动Insets处理，应该就能解决问题了！

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