Jetpack Compose TextField切后台后弹出错误键盘问题求助

问题现象 #

封装通用AppTextField组件并设置keyboardType为数字键盘后：

• 首次打开页面聚焦输入框，数字键盘正常弹出
• 应用切后台再返回，聚焦输入框时弹出文本键盘，且点击键盘数字无法输入内容
• 环境：Galaxy A24（Android 14）、Compose Material3 1.2.1

解决方案 #

1. 稳定键盘配置状态 #

Android 14后台恢复时可能重置输入法配置，用remember包裹keyboardOptions并明确指定imeAction，避免默认值的潜在问题：

// 修改AppTextField中的keyboardOptions参数
keyboardOptions = remember(keyboardType) {
    KeyboardOptions.Default.copy(
        keyboardType = keyboardType,
        imeAction = ImeAction.Done
    )
},

2. 焦点恢复时强制重置输入法 #

通过FocusRequester和LaunchedEffect监听焦点状态，后台返回后焦点恢复时手动请求输入法：

@Composable
fun AppTextField(
    modifier: Modifier = Modifier,
    value: String,
    label: String,
    singleLine: Boolean = true,
    readOnly: Boolean = false,
    enabled: Boolean = true,
    colors: TextFieldColors? = null,
    minLines: Int = 1,
    keyboardType: KeyboardType,
    visualTransformation: VisualTransformation = VisualTransformation.None,
    trailingIcon: @Composable (() -> Unit)? = null,
    leadingIcon: @Composable (() -> Unit)? = null,
    isError: Boolean = false,
    supportingText: @Composable (() -> Unit)? = null,
    onValueChanged: (String) -> Unit
){
    val focusRequester = remember { FocusRequester() }
    val focusState = remember { mutableStateOf(FocusState.Inactive) }
    val context = LocalContext.current

    OutlinedTextField(
        value = value,
        onValueChange = onValueChanged,
        label = { Text(text = label) },
        singleLine = singleLine,
        shape = RoundedCornerShape(8.dp),
        modifier = modifier
            .fillMaxWidth()
            .focusRequester(focusRequester)
            .onFocusChanged { focusState.value = it },
        colors = colors ?: OutlinedTextFieldDefaults.colors(
            focusedBorderColor = MaterialTheme.colorScheme.tertiary,
            unfocusedBorderColor = MaterialTheme.colorScheme.tertiary,
            disabledBorderColor = MaterialTheme.colorScheme.tertiary,
            disabledTextColor = MaterialTheme.colorScheme.onSurface,
            disabledLabelColor = MaterialTheme.colorScheme.onSurface,
        ),
        keyboardOptions = remember(keyboardType) {
            KeyboardOptions.Default.copy(
                keyboardType = keyboardType,
                imeAction = ImeAction.Done
            )
        },
        visualTransformation = visualTransformation,
        trailingIcon = trailingIcon,
        isError = isError,
        supportingText = supportingText,
        readOnly = readOnly,
        enabled = enabled,
        leadingIcon = leadingIcon,
        minLines = minLines
    )

    LaunchedEffect(focusState.value.isFocused) {
        if (focusState.value.isFocused) {
            delay(100) // 延迟确保系统状态稳定
            focusRequester.requestFocus()
            val inputMethodManager = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            inputMethodManager.showSoftInput(
                LocalView.current.findFocus(),
                InputMethodManager.SHOW_IMPLICIT
            )
        }
    }
}

3. 升级Compose Material3版本 #

该问题大概率是Material3 1.2.1的兼容性bug，建议升级到最新稳定版（如1.3.0及以上），Google后续版本已修复部分Android 14上的输入法适配问题。

4. 匹配视觉转换与键盘类型 #

若使用了visualTransformation，确保其与keyboardType匹配（比如数字键盘搭配NumberVisualTransformation），避免系统混淆输入法类型。

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