Jetpack Compose中LazyColumn删除项时触发IndexOutOfBoundsException

我在Jetpack Compose的LazyColumn中删除列表项时遇到了IndexOutOfBoundsException异常。以下代码可复现该错误：

val list = remember { mutableStateListOf(1, 2, 3) }

LazyColumn {
    itemsIndexed(list) { index, value ->
        Button(onClick = {
            list.removeAt(index)
        }) { Text(value.toString()) }
    }
}

点击按钮删除项时会触发该错误，但使用list.clear()或向列表添加项时无异常。我尝试过使用itemsIndexed(list) { index, value -> }等多种写法，但均未解决问题。

补充信息 #

• 使用id("org.jetbrains.kotlin.android") version "1.9.20"
• 使用kotlinCompilerExtensionVersion = "1.5.4"
• 使用Jetpack Compose：implementation(platform("androidx.compose:compose-bom:2023.10.01"))
• 使用Material3：implementation("androidx.compose.material3:material3:1.2.0-alpha11")
• 目标SDK版本为34。

解决建议 #

问题根源 #

itemsIndexed依赖列表的索引进行项的状态管理和复用，当删除项后列表长度缩短，LazyColumn重组过程中可能仍会依据旧的索引信息访问列表，导致索引越界。同时mutableStateListOf的通知机制在绑定索引使用时，容易出现索引与实际列表不匹配的情况。

具体解决方案 #

1. 使用带唯一键的items替代itemsIndexed（最优方案）

为列表项提供唯一标识，让LazyColumn通过键来识别项，而非依赖索引。修改代码如下：

val list = remember { mutableStateListOf(1, 2, 3) }

LazyColumn {
    items(list, key = { it }) { value ->
        Button(onClick = {
            list.remove(value)
        }) { Text(value.toString()) }
    }
}

如果列表项是自定义数据类，建议使用数据类的唯一ID字段作为键（比如key = { item.id }），删除时直接移除对应项，从根源避免索引不匹配问题。

2. 索引操作时增加合法性检查（临时规避）

如果业务逻辑必须依赖索引，可在删除前增加索引合法性判断：

val list = remember { mutableStateListOf(1, 2, 3) }

LazyColumn {
    itemsIndexed(list) { index, value ->
        Button(onClick = {
            if (index < list.size) {
                list.removeAt(index)
            }
        }) { Text(value.toString()) }
    }
}

但这种方式仅为临时规避，无法彻底解决索引绑定带来的潜在问题。

3. 升级Compose稳定版本

你当前使用的Material3是alpha版本，部分旧版Compose可能存在LazyColumn与mutableStateListOf交互的Bug。建议升级到最新稳定版的Compose BOM和Material3，大概率能修复这类索引异常问题。

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