Android Jetpack Compose：底部弹窗遮挡键盘问题求助

原因分析 #

Compose 的 Popup 默认挂载在应用窗口的 DecorView 层级，软键盘弹出时系统会调整应用窗口布局，但 Popup 的布局参数未同步响应这种调整，导致它停留在原位置被键盘覆盖。

解决方案 #

1. 处理窗口Insets适配键盘 #

通过 Modifier.windowInsetsPadding(WindowInsets.ime) 让 Popup 自动适配键盘高度，确保内容不会被键盘挡住：

Popup(
    alignment = Alignment.BottomCenter
) {
    Surface(
        modifier = Modifier
            .fillMaxWidth()
            .windowInsetsPadding(WindowInsets.ime),
        elevation = 8.dp
    ) {
        TextField(
            value = text,
            onValueChange = { text = it },
            modifier = Modifier.fillMaxWidth()
        )
    }
}

2. 配置Popup的软键盘模式 #

通过 PopupProperties 设置软键盘调整模式，强制系统调整 Popup 所在窗口的布局来适配键盘：

Popup(
    alignment = Alignment.BottomCenter,
    properties = PopupProperties(
        softInputMode = SoftInputMode.AdjustResize
    )
) {
    // 弹窗内容布局
}

注意事项 #

• 确保使用较新版本的 Compose 依赖，旧版本可能存在 Insets 处理的 bug；
• 如果弹窗内包含滚动布局，需结合 verticalScroll 和 windowInsetsPadding 一起使用，保证内容可滚动至键盘上方。

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