Jetpack Compose TextField设置最大长度时异常清空文本该如何解决？

这个异常是Jetpack Compose 1.3.0及更早版本中TextField的已知底层bug，触发原因是输入法的候选组合文本（比如拼音输入未选字时的高亮文本）状态和手动截断文本的逻辑冲突：当输入长度刚好触及40的框架默认组合文本缓冲阈值时，截断操作会清除输入法的组合状态标记，输入框架误将有效文本识别为无效的临时组合文本直接清空；第二次输入时组合状态已经重置，所以不会复现异常。低于40的长度不会触发缓冲阈值判断，因此运行正常。

方案1：升级依赖版本（优先推荐） #

将Compose Material组件版本升级到1.4.0及以上，官方已经在后续版本修复了该bug，原有代码的写法可以正常运行，无需修改逻辑。

方案2：兼容低版本的实现方式 #

如果无法升级Compose版本，修改长度判断逻辑即可规避异常：

var text by remember { mutableStateOf("") }
val maxLength = 40
TextField(
    value = text,
    onValueChange = { newText ->
        // 仅当新文本长度未超出限制时才更新状态，避免截断组合文本触发状态冲突
        if (newText.length <= maxLength) {
            text = newText
        }
    },
    // 可选：添加字符计数提示，优化用户体验
    supportingText = {
        Text("${text.length}/$maxLength")
    }
)

如果需要实现超出长度后自动截断末尾字符的效果，可以使用如下兼容写法：

var text by remember { mutableStateOf("") }
val maxLength = 40
TextField(
    value = text,
    onValueChange = { newText ->
        text = newText.take(maxLength)
    },
    // 显式关闭输入预测，规避组合状态冲突
    keyboardOptions = KeyboardOptions(
        autoCorrect = false
    )
)

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