Jetpack Compose键盘弹出时LazyColumn与TextField布局异常解决咨询

核心问题分析 #

你的代码里存在几个关键问题导致键盘弹出时TextField无法正常显示：

• 首屏布局中LazyColumn和输入区域直接并列，未通过权重分配空间，导致键盘弹出时布局无法正确调整
• 同时设置了adjustResize和adjustPan两种软键盘模式，两者互斥，导致布局调整逻辑冲突
• 滥用实验性的BringIntoViewRequester，且全局使用GlobalScope存在潜在内存泄漏风险

非实验性修复步骤 #

1. 统一软键盘模式

只保留AndroidManifest.xml中的设置，删除MainActivity里的window.setSoftInputMode代码：

<activity
    android:name=".MainActivity"
    android:windowSoftInputMode="adjustResize">
    <!-- 其他配置 -->
</activity>

2. 重构首屏布局

用Column包裹LazyColumn和输入区域，给LazyColumn设置weight(1f)让它占满剩余空间，输入区域自然固定在底部：

var index by remember { mutableStateOf(1) } // 改成remember状态变量，避免全局变量问题

@Composable
fun FirstScreen() {
    val list = remember { mutableStateListOf<Message>() }
    val botList = listOf("Peter", "Francesca", "Luigi", "Igor")
    val random = (0..3).random()
    val botName: String = botList[random]
    val hashMap = remember { HashMap<String, String>() }
    val coroutineScope = rememberCoroutineScope()

    // 用rememberCoroutineScope启动消息，替代GlobalScope
    LaunchedEffect(Unit) {
        coroutineScope.launch {
            customBotMessage(message = Message1, list)
        }
    }

    Column(modifier = Modifier.fillMaxSize()) {
        LazyColumn(modifier = Modifier.weight(1f)) {
            items(list.size) { i ->
                if (list[i].id == RECEIVE_ID)
                    Item(message = list[i], botName)
                else
                    Item(message = list[i], "User")
            }
        }
        SimpleOutlinedTextFieldSample(list, hashMap)
    }
}

3. 简化输入区域代码

去掉所有实验性的BringIntoViewRequester相关代码，保持布局简洁：

@Composable
fun SimpleOutlinedTextFieldSample(
    list: SnapshotStateList<Message>,
    hashMap: HashMap<String, String>
) {
    val keyboardController = LocalSoftwareKeyboardController.current
    val coroutineScope = rememberCoroutineScope()
    var text by remember { mutableStateOf("") }

    Column(
        verticalArrangement = Arrangement.Bottom,
        horizontalAlignment = Alignment.CenterHorizontally,
        modifier = Modifier.fillMaxWidth()
    ) {
        Row(
            modifier = Modifier.fillMaxWidth(),
            verticalAlignment = Alignment.Bottom,
            horizontalArrangement = Arrangement.Center
        ) {
            OutlinedTextField(
                modifier = Modifier
                    .padding(8.dp)
                    .weight(1f), // 让TextField占满剩余宽度
                keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done),
                keyboardActions = KeyboardActions(onDone = { keyboardController?.hide() }),
                value = text,
                onValueChange = { text = it },
                label = { Text("发送消息") })
            IconButton(onClick = {
                if (text.isNotEmpty()) {
                    list.add(
                        Message(
                            text,
                            SEND_ID,
                            Timestamp(System.currentTimeMillis()).toString()
                        )
                    )
                    hashMap.put(listOfMessageKeys[index - 1], text)
                    coroutineScope.launch {
                        customBotMessage(listOfMessages[index], list)
                    }
                    index += 1
                }
                text = ""
            }) {
                Icon(
                    modifier = Modifier.padding(8.dp),
                    painter = painterResource(id = R.drawable.ic_baseline_send_24),
                    contentDescription = "发送消息图标"
                )
            }
        }
    }
}

4. 替换GlobalScope

把全局协程换成局部的CoroutineScope，避免内存泄漏：

private suspend fun customBotMessage(message: String, list: SnapshotStateList<Message>) {
    delay(1000)
    list.add(Message(message, RECEIVE_ID, Timestamp(System.currentTimeMillis()).toString()))
}

5. 简化Item组件

去掉所有实验性注解和BringIntoViewRequester相关代码，文本无需焦点监听：

@Composable
fun Item(
    message: Message,
    person: String,
) {
    Card(
        modifier = Modifier
            .padding(10.dp)
            .fillMaxWidth(), // 让卡片占满宽度，符合聊天界面习惯
        elevation = 10.dp
    ) {
        Column(
            horizontalAlignment = Alignment.Start,
            verticalArrangement = Arrangement.Top,
            modifier = Modifier.padding(10.dp)
        ) {
            Row(
                verticalAlignment = Alignment.CenterVertically,
                modifier = Modifier.padding(4.dp)
            ) {
                Text(
                    buildAnnotatedString {
                        withStyle(style = SpanStyle(fontWeight = FontWeight.Light)) {
                            append("$person: ")
                        }
                    },
                    modifier = Modifier.padding(end = 8.dp)
                )
                Text(
                    buildAnnotatedString {
                        withStyle(
                            style = SpanStyle(
                                fontWeight = FontWeight.W900,
                                color = Color(0xFF4552B8)
                            )
                        ) {
                            append(message.message)
                        }
                    }
                )
            }
        }
    }
}

修复原理 #

• adjustResize模式会在键盘弹出时重新计算布局高度，配合Column+weight(1f)的布局结构，LazyColumn自动收缩高度，底部TextField始终保持可见
• 移除实验性API后，布局逻辑更稳定，避免兼容性问题
• 用rememberCoroutineScope替代GlobalScope，保证协程生命周期与组件一致，避免内存泄漏

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