Jetpack Compose TextField软键盘遮挡输入问题求助

我之前在Jetpack Compose开发中也碰到过一模一样的软键盘异常遮挡问题，结合你的代码和场景，这里分享几个亲测有效的解决方案：

1. 结合Accompanist IME库手动控制布局偏移 #

既然你之前用过Accompanist解决过TextField相关问题，可以试试它的IME Insets库来更精准地处理键盘弹出后的布局调整。

首先确保你已经引入了Accompanist IME依赖，然后修改你的EditTextContent，通过rememberImeState监听键盘状态，动态调整布局：

@Composable
fun EditTextContent(
    label: String,
    text: String,
    isError: Boolean,
    modifier: Modifier = Modifier,
    singleLine: Boolean,
    inputType: KeyboardType = KeyboardType.Text,
    onTextChanged: (String) -> Unit
) {
    val focusManager = LocalFocusManager.current
    val imeState = rememberImeState() // 监听键盘弹出/收起状态
    val coroutineScope = rememberCoroutineScope()

    OutlinedTextField(
        modifier = modifier
            .navigationBarsWithImePadding()
            .testTag(label)
            // 键盘弹出时触发延迟布局调整
            .then(
                if (imeState.isOpen) {
                    Modifier.onGloballyPositioned {
                        coroutineScope.launch {
                            delay(100) // 给系统预留响应时间
                            // 若需要保持输入焦点，可替换为重新请求焦点
                            focusManager.clearFocus()
                        }
                    }
                } else Modifier
            ),
        value = text,
        onValueChange = { onTextChanged(it) },
        label = { Text(label) },
        singleLine = singleLine,
        keyboardActions = KeyboardActions(onDone = {
            coroutineScope.launch {
                delay(50) // 延迟清焦点，让系统先完成布局调整
                focusManager.clearFocus()
            }
        }),
        keyboardOptions = KeyboardOptions(
            keyboardType = inputType,
            imeAction = if (singleLine) ImeAction.Done else ImeAction.Next
        ),
        isError = isError,
        trailingIcon = {
            if (isError) {
                Icon(
                    painter = painterResource(id = R.drawable.ic_warning),
                    modifier = Modifier.size(25.dp),
                    contentDescription = null
                )
            } else {
                null
            }
        },
    )
}

2. 调整windowSoftInputMode并配合Compose Insets处理 #

你当前用的是adjustPan，可以尝试改为adjustResize，同时确保Activity开启了系统Insets的适配：

在你的Activity的onCreate方法中添加：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    WindowCompat.setDecorFitsSystemWindows(window, false)
    setContent {
        // 你的Compose根内容
    }
}

然后将Manifest中的android:windowSoftInputMode改为adjustResize，再把Modifier.imePadding()放在navigationBarsWithImePadding之后（确保键盘优先级更高）。

3. 回车键后手动触发焦点重绘 #

有时候直接清焦点会导致系统来不及调整布局，你可以先临时移动焦点再清，强制触发布局刷新：

keyboardActions = KeyboardActions(onDone = {
    coroutineScope.launch {
        // 临时移动焦点触发布局调整
        focusManager.moveFocus(FocusDirection.Center)
        delay(100)
        focusManager.clearFocus()
    }
}),

关于已分配的Issue #

既然这个问题已经有官方分配的Issue，你可以跟进Issue的修复进展，上述的Workaround可以临时解决当前问题，直到官方推出正式修复。

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