Android问题：Jetpack Compose TextField中三星键盘自动替换异常

问题现象 #

启用三星键盘的**自动替换（Auto replace）和文本纠错建议（Suggest Text Correction）**功能后，快速输入并按下回车键，键盘的纠错建议文本有时会被插入到新行中。该问题仅出现在当前应用，短信等其他第三方应用无此异常。

使用环境 #

Material3 版本依赖：

implementation "androidx.compose.material3:material3:1.1.2"

相关代码 #

TextField 实现 #

TextField(
    value = textField,
    modifier = Modifier
        .background(
            color = SampleTheme.customColors.background,
            shape = RoundedCornerShape(size = 32.dp)
        )
        .padding(start = 6.dp, end = 6.dp)
        .animateContentSize()
        .wrapContentHeight()
        .weight(0.7f)
        .focusRequester(focusRequester),
    colors = TextFieldDefaults.colors(
        focusedContainerColor = Color.Transparent,
        unfocusedContainerColor = Color.Transparent,
        disabledContainerColor = Color.Transparent,
        cursorColor = SampleTheme.customColors.colorAccent,
        focusedIndicatorColor = Color.Transparent,
        unfocusedIndicatorColor = Color.Transparent,
        selectionColors = TextSelectionColors(
            handleColor = SampleTheme.customColors.colorAccent,
            backgroundColor = SampleTheme.customColors.colorAccent.copy(
                alpha = 0.4f
            )
        )
    ),
    onValueChange = {
        textField = it
        viewModel.onTextChange(it)
    },
    shape = RoundedCornerShape(8.dp),
    placeholder = {
        Text(
            text = stringResource(R.string.message_input_placeholder),
            style = TextStyle(
                fontSize = 12.sp,
                fontFamily = TestFont().iransans,
                fontWeight = FontWeight.Light,
                color = SampleTheme.customColors.hintColor,
            )
        )
    },
    textStyle = TextStyle(
        fontSize = 14.sp,
        color = SampleTheme.customColors.textColor,
        fontWeight = FontWeight.Normal,
        fontFamily = TestFont().iransans,
        textDirection = TextDirection.ContentOrLtr
    ),
    trailingIcon = {
        // Keyboard
        AnimatedVisibility(
            visible = state.emojiPicker,
            enter = fadeIn(),
            exit = fadeOut(),
        ) {
            KeyboardIcon(onClick = {
                controller?.show()
                viewModel.switchEmojiPickerState(
                    HistoryUiIntent.SwitchEmojiPickerState
                )
            })
        }
        // Emoji
        AnimatedVisibility(
            visible = !state.emojiPicker,
            enter = fadeIn(),
            exit = fadeOut()
        ) {
            SmileyIcon(onClick = {
                controller?.hide()
                viewModel.switchEmojiPickerState(
                    HistoryUiIntent.SwitchEmojiPickerState
                )
            })
        }
    },
)

文本状态变量定义 #

var textField by remember {
    mutableStateOf(
        TextFieldValue(
            DraftHelper.initialTextFieldValue(
                threadModel?.id ?: 0
            )
        )
    )
}

问题示例 #

原因分析 #

1. 版本兼容性问题：使用的Material3 1.1.2版本可能存在输入事件处理bug，与三星键盘这类第三方输入法的交互时序不匹配，导致回车键换行操作和自动纠错文本替换事件冲突。
2. 状态管理冲突：直接用TextFieldValue管理文本状态，其包含光标位置、选择范围等额外信息，快速操作时状态更新时序与输入法事件推送不同步，引发内容错位。
3. 布局动画影响：animateContentSize修饰符导致TextField布局更新延迟，干扰输入事件即时处理，加剧时序冲突。
4. 业务逻辑阻塞：onValueChange中同步调用viewModel.onTextChange(it)，若该操作耗时会阻塞UI线程，导致文本状态更新不及时，与输入法操作不同步。

解决方法 #

1. 升级Material3版本：将依赖升级至最新稳定版（如1.2.1或更高），新版本通常会修复输入法交互相关bug。
2. 改用String类型状态：替换TextFieldValue为String变量，让Compose自动处理光标和选择状态，减少手动管理的冲突：

   var textField by remember { mutableStateOf(DraftHelper.initialTextFieldValue(threadModel?.id ?: 0)) }
   

   同时修改TextField的value参数为该String变量，onValueChange直接更新字符串即可。
3. 移除布局动画：暂时移除animateContentSize验证是否是动画导致的问题；若需保留，可调整动画时长或使用更轻量的配置。
4. 异步处理业务逻辑：将viewModel.onTextChange(it)放入协程执行，避免阻塞UI线程：

   onValueChange = {
       textField = it
       LaunchedEffect(it) {
           viewModel.onTextChange(it)
       }
   }
   

5. 检查初始状态：确认DraftHelper.initialTextFieldValue返回的文本内容和光标位置正确，避免初始状态异常影响后续输入。

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