Jetpack Compose中imePadding重复生效问题（特定设备）

问题场景与现象 #

在Scaffold的bottomBar中给包含TextField的容器添加了imePadding()修饰符，同时在代码中设置了window.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)，键盘弹出时底部Bar的padding会被叠加两次，导致Bar位置异常偏高，该问题仅在部分设备出现（测试设备为三星Galaxy A80，Android11）。

复现代码 #

Scaffold(
    modifier = Modifier.fillMaxSize(),
    bottomBar = {
        Box(
            Modifier
                .imePadding()
                .height(100.dp)
                .background(Color.Red),
        ) {
            BasicTextField(
                modifier = Modifier.fillMaxWidth(),
                value = "some text",
                onValueChange = {},
            )
        }
    },
) {
    Box(
        Modifier.fillMaxSize().padding(bottom = it.calculateBottomPadding()),
    ) {
        LazyColumn(
            modifier = Modifier.fillMaxSize(),
        ) {
            repeat((0..100).count()) {
                item {
                    Box(Modifier.fillMaxWidth().height(100.dp).background(Color.Blue)) {
                    }
                }
            }
        }
    }
}
// 触发问题的关键代码
window.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)

问题原因 #

FLAG_LAYOUT_NO_LIMITS会让应用Window忽略系统UI（包括软键盘）的布局边界限制，而Jetpack Compose的imePadding()是基于系统传递的WindowInsets计算的。在三星A80的Android11系统中，开启该flag后，系统会重复传递IME相关的Insets值，导致imePadding()被应用两次，出现叠加效果。

解决方案 #

方案1：移除FLAG_LAYOUT_NO_LIMITS #

如果业务场景不需要这个窗口flag，直接删除window.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)代码，imePadding()就能正常工作，不会出现重复生效的问题。

方案2：手动处理Insets（保留flag时使用） #

如果必须保留该flag，可以通过手动计算或消费Insets来避免重复叠加：

方式A：手动计算单次IME Padding

val windowInsets = LocalWindowInsets.current
// 取IME insets和导航栏+系统手势insets的较小值，避免重复叠加
val singleImePadding = windowInsets.ime.bottom.coerceAtMost(
    windowInsets.navigationBars.bottom + windowInsets.systemGestures.bottom
)

// 用padding代替imePadding
Box(
    Modifier
        .padding(bottom = singleImePadding.dp)
        .height(100.dp)
        .background(Color.Red)
) {
    BasicTextField(
        modifier = Modifier.fillMaxWidth(),
        value = "some text",
        onValueChange = {},
    )
}

方式B：消费IME Insets避免重复应用

Scaffold(
    modifier = Modifier.fillMaxSize(),
    bottomBar = {
        Box(
            Modifier
                .imePadding()
                .consumeWindowInsets(WindowInsets.ime) // 消费IME insets，防止后续重复应用
                .height(100.dp)
                .background(Color.Red),
        ) {
            BasicTextField(/*...*/)
        }
    },
) { paddingValues ->
    Box(
        Modifier.fillMaxSize().padding(bottom = paddingValues.calculateBottomPadding()),
    ) {
        // ... 列表内容
    }
}

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