Android Compose ModalBottomSheet在三星设备上键盘交互异常

问题原因 #

该异常是三星One UI系统与Jetpack Compose Material3的ModalBottomSheet在键盘弹出时的布局适配冲突导致的。三星设备的系统键盘唤起时，窗口Insets的计算逻辑和原生Android（如Pixel设备）存在差异，而ModalBottomSheet默认的布局处理逻辑未兼容这种差异，进而引发弹窗被遮挡、布局偏移或内容压缩等显示异常。

可行解决方案 #

方案1：添加窗口Insets适配 #

在BottomSheet的内容根布局中，显式添加输入法（IME）窗口Insets的padding，确保弹窗能正确响应键盘高度变化：

修改TagInputBottomSheet中的Column修饰符：

Column(
    modifier = Modifier
        .fillMaxWidth()
        .padding(20.dp)
        .windowInsetsPadding(WindowInsets.ime) // 适配输入法Insets
)

注意：确保你的Compose Material3版本在1.1.0及以上，新版本对Insets的处理更完善。

方案2：调整ModalBottomSheet状态配置 #

将sheetState设置为跳过部分展开状态，避免三星设备上的状态切换冲突：

val sheetState = rememberModalBottomSheetState(
    skipPartiallyExpanded = true // 跳过部分展开状态
)

ModalBottomSheet(
    onDismissRequest = onDismiss,
    sheetState = sheetState,
) {
    // 原有弹窗内容
}

方案3：手动联动键盘状态与弹窗高度 #

通过监听键盘可见性，手动控制弹窗切换到完全展开状态：

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun TagInputBottomSheet(
    onDismiss: () -> Unit,
    onTagInput: (String) -> Unit
) {
    val isKeyboardVisible = WindowInsets.isImeVisible
    val sheetState = rememberModalBottomSheetState()
    val scope = rememberCoroutineScope()

    LaunchedEffect(isKeyboardVisible) {
        if (isKeyboardVisible) {
            scope.launch { sheetState.expand() }
        }
    }

    ModalBottomSheet(
        onDismissRequest = onDismiss,
        sheetState = sheetState,
    ) {
        // 原有弹窗内容
    }
}

方案4：替换为ModalBottomSheetLayout（备选） #

若Material3的ModalBottomSheet问题无法解决，可尝试使用ModalBottomSheetLayout组件，其布局逻辑更稳定：

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun TagInputBottomSheet(
    onDismiss: () -> Unit,
    onTagInput: (String) -> Unit
) {
    val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = true)
    val scope = rememberCoroutineScope()

    ModalBottomSheetLayout(
        sheetState = sheetState,
        sheetContent = {
            // 原有弹窗内容
        },
        onDismissRequest = { 
            scope.launch { sheetState.hide() }.invokeOnCompletion { onDismiss() } 
        }
    ) {
        // 空占位，弹窗独立显示
    }
}

临时规避方案 #

如果以上方案无法立即生效，可在弹窗显示时强制调整Activity的软键盘模式：
在Fragment的onViewCreated中添加：

requireActivity().window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)

弹窗关闭后恢复原有模式：

// 在onDismiss回调中执行
requireActivity().window.setSoftInputMode(原有软键盘模式)

内容的提问来源于stack exchange，提问作者dev.farmer