Android Compose：点击按钮首次无法唤起软键盘问题求助

App启动后点击按钮，软键盘无法弹出；但点击TextField唤起键盘并关闭后，再次点击按钮，软键盘却能正常弹出。

原代码： #

val focusRequester = remember { FocusRequester() }
val keyboard = LocalSoftwareKeyboardController.current

Scaffold(
    modifier = Modifier.fillMaxSize(),
) {
    Box(
        modifier = Modifier
            .fillMaxSize()
            .padding(it)
    ) {
        TextField(
            value = "", onValueChange = {}, modifier = Modifier.align(
                Alignment.TopCenter
            )
        )
        Button(
            onClick = {
                keyboard?.show()
                focusRequester.captureFocus()
            },
            modifier = Modifier
                .focusRequester(focusRequester)
                .align(Alignment.BottomCenter)
        ) {

        }
    }
}

问题原因： #

1. Button默认不可聚焦：Compose的Button组件默认未开启focusable特性，导致首次调用focusRequester.captureFocus()时无法获取焦点，而系统软键盘需要有已获得焦点的可聚焦组件才会触发弹出。
2. 操作顺序错误：原代码先调用keyboard?.show()再请求焦点，此时系统没有可绑定的焦点目标，键盘唤起逻辑不生效。
3. TextField操作后的状态残留：点击TextField后，系统初始化了焦点管理相关的状态，即使Button焦点逻辑有缺陷，也可能借助残留状态唤起键盘，但这不属于正常逻辑。

解决方案： #

修改Button的修饰符和点击逻辑，确保焦点请求成功后再唤起键盘：

val focusRequester = remember { FocusRequester() }
val keyboard = LocalSoftwareKeyboardController.current

Scaffold(
    modifier = Modifier.fillMaxSize(),
) { paddingValues ->
    Box(
        modifier = Modifier
            .fillMaxSize()
            .padding(paddingValues)
    ) {
        TextField(
            value = "", 
            onValueChange = {}, 
            modifier = Modifier.align(Alignment.TopCenter)
        )
        Button(
            onClick = {
                // 先请求焦点，成功后再唤起键盘
                val isFocusCaptured = focusRequester.captureFocus()
                if (isFocusCaptured) {
                    keyboard?.show()
                }
            },
            modifier = Modifier
                .focusRequester(focusRequester)
                .focusable(true) // 关键：让Button具备可聚焦能力
                .align(Alignment.BottomCenter)
        ) {
            Text("唤起软键盘")
        }
    }
}

修改说明： #

• 添加.focusable(true)：开启Button的可聚焦特性，确保焦点请求能成功执行。
• 调整操作顺序：先调用captureFocus()并验证结果，只有焦点获取成功时才唤起键盘，匹配系统软键盘的唤起逻辑。
• 新增Button文本（可选）：方便测试和识别功能按钮。

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