LazyColumn滚动崩溃：java.lang.IllegalStateException: replace()调用异常

核心问题定位 #

崩溃java.lang.IllegalStateException: replace() called on item that was not placed源于LazyColumn的item状态管理异常，结合代码来看，主要存在以下几个问题：

1. 列表修改未遵循Compose状态驱动原则 #

直接调用facts.add(FactIO())修改普通MutableList，Compose无法精准感知列表变化时机，导致LazyColumn的item复用机制混乱，复杂布局的item更容易触发布局状态冲突。

2. InteractiveCardState的管理逻辑错误 #

• 用index绑定interactiveStates不可靠：LazyColumn滚动时item会被复用，index对应的实际数据会变化，若interactiveStates未与数据唯一标识绑定，会导致状态和item错位。
• 在itemsIndexed的lambda中直接调用rememberInteractiveCardState()，作用域错误：item被回收复用时，新item会重新创建state，旧state的残留会干扰布局更新，触发replace()调用异常。
• 同一个item中两次调用interactiveStates.getOrNull(index) ?: rememberInteractiveCardState()，可能生成两个不同的state实例，导致状态不一致。

3. 选中集合未使用状态容器 #

selectedFactsUids.add/remove(fact.uid)直接修改普通集合，无法触发Compose重组，且可能与LazyColumn的item更新产生并发冲突。

具体修复步骤 #

步骤1：将列表切换为Compose状态容器 #

把facts从普通MutableList改为MutableStateList，确保Compose能感知列表变化：

// 初始化示例
val facts = rememberSaveable { mutableStateListOf<FactIO>() }

添加新item时直接操作这个StateList，Compose会正确触发LazyColumn的更新：

BrandHeaderButton(
    // ...其他参数
) {
    facts.add(FactIO())
}

步骤2：用数据唯一标识绑定InteractiveCardState #

放弃用index管理interactiveStates，改用fact.uid作为key，确保每个数据项对应唯一的状态实例：

// 初始化状态容器
val interactiveStates = rememberSaveable { mutableStateMapOf<String, InteractiveCardState>() }

// 在itemsIndexed中获取状态
itemsIndexed(facts) { index, fact ->
    val state = interactiveStates.getOrPut(fact.uid) {
        rememberInteractiveCardState()
    }
    LaunchedEffect(state.isChecked.value) {
        if (state.isChecked.value) {
            selectedFactsUids.add(fact.uid)
        } else {
            selectedFactsUids.remove(fact.uid)
        }
    }
    FactCard(
        data = fact,
        state = state,
        requestDataSave = requestFactSave
    )
}

通过mutableStateMapOf存储状态，用fact.uid确保状态和数据项一一绑定，避免item复用导致的状态错位。

步骤3：将选中集合改为State容器 #

把selectedFactsUids改为MutableStateList：

val selectedFactsUids = rememberSaveable { mutableStateListOf<String>() }

集合变化时，相关依赖的Compose组件能正确重组，避免状态不一致。

步骤4：优化StickyHeader的布局动画 #

StickyHeader中的animateContentSize()可能和LazyColumn的滚动布局产生冲突，可暂时移除测试是否还崩溃：

BrandHeaderButton(
    modifier = (if (facts.size > 0) {
        Modifier.weight(0.45f)
    } else Modifier.requiredSize(0.dp))
        .zIndex(100f),
    // ...其他参数
)

额外验证点 #

• 检查FactCard内部是否存在自定义布局或动画逻辑，这类复杂逻辑可能在item复用和状态更新时触发布局异常，可暂时替换为简单布局测试，定位是否是FactCard的问题。
• 确保所有状态修改都在Compose的状态容器（MutableState、MutableStateList、MutableStateMap）中进行，禁止直接修改普通集合或变量。

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