Jetpack Compose OutlinedTextField获取焦点后软键盘不弹出问题

实现弹出对话框时自动将焦点定位到OutlinedTextField组件，让用户无需额外点击即可直接输入内容。实际运行时输入框已成功获取焦点、光标处于闪烁状态，软键盘却未自动弹出，用户仍需手动点击输入框才能唤起键盘进行输入。
原有实现代码如下：

LaunchedEffect(Unit) {
    focusRequester.requestFocus()
}

OutlinedTextField(
    value = text,
    modifier = Modifier
        .focusRequester(focusRequester)
        .fillMaxWidth(),
    onValueChange = {
        text = it
    }
)

Jetpack Compose中组件焦点状态和软键盘（IME）唤起是两套独立的控制逻辑：仅调用focusRequester.requestFocus()只会修改组件的焦点状态，让输入框显示闪烁光标，不会主动触发软键盘的显示指令，因此会出现光标闪烁但键盘未弹出的现象。
另外如果焦点请求时机早于输入框完成视图附着、对话框完成渲染，即使后续补充键盘唤起逻辑，也可能因为时序问题失效。

需要配合SoftwareKeyboardController主动触发软键盘显示，同时保证执行时序在输入框完成布局、焦点生效之后，具体实现代码如下：

// 初始化需要的实例
val focusRequester = remember { FocusRequester() }
val keyboardController = LocalSoftwareKeyboardController.current
var inputText by remember { mutableStateOf("") }

LaunchedEffect(Unit) {
    // 先为输入框请求焦点
    focusRequester.requestFocus()
    // 等待下一帧渲染完成，确保输入框已成功挂载、焦点状态生效
    withFrameNanos {
        // 帧渲染完成后主动唤起软键盘
        keyboardController?.show()
    }
}

OutlinedTextField(
    value = inputText,
    modifier = Modifier
        .focusRequester(focusRequester)
        .fillMaxWidth(),
    onValueChange = {
        inputText = it
    }
)

注意事项 #

• 如果输入框放在AlertDialog、Dialog等弹窗组件内，上述逻辑必须写在弹窗的内部Composition作用域中，不要放在弹窗外部，否则会因为弹窗未完成渲染导致时序错误。
• 部分深度定制的安卓ROM默认禁止应用自动唤起软键盘，如果代码在原生安卓系统运行正常、在特定定制系统失效，属于系统层面的限制，不属于代码逻辑问题。
• 不要在唤起键盘前增加不必要的长延迟，否则会出现弹窗弹出后键盘慢半拍弹出的割裂感，等待单帧的时序稳定性最高。

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