Jetpack Compose更新mutableStateListOf触发IndexOutOfBoundsException异常

问题根本原因 #

你遇到的IndexOutOfBoundsException是状态更新时序和Lazy组件渲染逻辑不匹配导致的，核心问题有三个：

• 你在Dispatchers.Default后台线程分两步修改mutableStateListOf：clear()和addAll()是两次独立的状态变更，每次变更都会触发Compose重组，两次变更的间隙存在临时空列表的中间状态，和重组进度不同步就会出现越界。
• LazyVerticalGrid的items(count)方法会先读取当前列表长度作为渲染总数量，等到对应位置的item进入可视区域要渲染时，才会执行lambda内的取值逻辑。如果这中间列表长度被修改，就会出现之前读取的index大于当前列表实际长度的情况。
• 你添加的if (index < arrayList.size)判断只能覆盖绝大多数场景，但如果判断执行完成到arrayList[index]取值的极短间隙，列表刚好被修改清空，依然会有概率触发异常。

为什么替换为arrayListOf后问题解决 #

普通的arrayListOf不是Compose可观察状态，修改其内容不会主动触发重组。你替换后必然是将整个ArrayList包裹在MutableState中，更新时一次性替换整个列表实例，仅触发一次重组，没有中间修改状态，自然不会出现时序不同步的越界问题。

推荐的标准修复方案 #

方案1：使用MutableState<List<T>>替代mutableStateListOf（最推荐） #

直接将整个列表作为状态值，更新时一次性替换，不存在中间修改状态，同时可以直接使用Lazy组件的items扩展方法，不用手动处理索引，从根源避免越界：

val loading = mutableStateOf(false)
val listState = mutableStateOf(emptyList<String>())

fun loadData() {
  coroutineScope.launch(Dispatchers.Default) {
    // 后台线程获取数据
    val newData = getData()
    // 切主线程更新状态
    withContext(Dispatchers.Main) {
      loading.value = true
      listState.value = newData
      loading.value = false
    }
  }
}

// 布局部分
if (loading.value) {
  // Loading Placeholder
} else {
  if (listState.value.isEmpty()) {
    // Empty Placeholder
  } else {
    LazyVerticalGrid(/* 你的网格配置 */) {
      // 直接传入列表实例，不用手动处理索引
      items(listState.value) { item ->
        ItemLayout(item)
      }
    }
  }
}

方案2：用快照事务包裹mutableStateListOf的修改操作 #

如果你一定要使用mutableStateListOf，可以将多步修改操作包裹在快照事务中，合并为一次原子状态变更，不会触发中间状态的重组：

import androidx.compose.runtime.snapshots.Snapshot

val loading = mutableStateOf(false)
val arrayList = mutableStateListOf<String>()

fun loadData() {
  coroutineScope.launch(Dispatchers.Default) {
    val newData = getData()
    withContext(Dispatchers.Main) {
      loading.value = true
      // 快照事务内的所有状态修改会合并为一次变更通知
      Snapshot.withMutableSnapshot {
        arrayList.clear()
        arrayList.addAll(newData)
      }
      loading.value = false
    }
  }
}

方案3：调整列表更新线程 #

不要在后台线程直接修改可观察状态列表，所有状态修改都放到主线程执行，避免多线程并发修改带来的时序问题，上述两个示例已经遵循了这个原则。

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