Android Compose LazyColumn报Key was already used异常如何解决？

• 当前示例中使用item.hashCode()作为key是不可靠的：data class的hashCode由所有构造参数共同生成，若同id条目修改了isDeleted/message属性会导致hashCode变化，极端情况下还会出现不同id条目hash冲突的问题，即便之前尝试过用id作为key，也要确保直接用原始id值，不要做任何额外转换。
• mutableStateListOf不是线程安全的：若repo.getData()的数据流在非主线程发射数据，直接在collect中修改列表会引发并发修改，导致列表状态混乱，出现重复添加相同key条目的问题，这是快速添加场景下报错的核心诱因。
• 缺少重复条目校验逻辑：如果上游数据流重复发射相同id的Entity，原有addNewItem方法会直接把重复条目加入列表，直接触发key重复异常。
• 单条更新频率过高：短时间内连续触发多次列表增改，Compose重组速度跟不上状态更新速度，中间过渡状态的列表可能出现key冲突。

1. 替换为稳定的唯一key #

直接使用Entity中唯一的id字段作为LazyColumn的item key，不要用hashCode：

items(
    items = viewmodel.messages,
    key = { item -> item.id }, // 直接用唯一id作为key
    itemContent = { item: Entity ->
        if (item.isDeleted) {
            //show deleted ui
        } else {
            //show messages
        }
    }
)

2. 保证列表修改的线程安全性 #

所有对mutableStateListOf的修改操作必须切换到主线程执行，或者改用StateFlow的原子更新方式：

方案A：修正现有mutableStateListOf的更新逻辑 #

fun observeDataFromDB() {
    viewModelScope.launch {
        repo.getData()
            .flowOn(Dispatchers.IO) // 数据流处理放在IO线程
            .collect { newEntity ->
                // 列表修改切换到主线程
                withContext(Dispatchers.Main.immediate) {
                    _messages.addNewItem(newEntity)
                }
            }
    }
}

方案B：改用StateFlow作为数据源（更稳定） #

// ViewModel 代码
private val _messages = MutableStateFlow<List<Entity>>(emptyList())
val messages: StateFlow<List<Entity>> = _messages.asStateFlow()

fun observeDataFromDB() {
    viewModelScope.launch {
        repo.getData().collect { newEntity ->
            _messages.update { oldList ->
                buildList {
                    add(newEntity)
                    addAll(oldList)
                    if (size >= MAX_SIZE) {
                        removeLast()
                    }
                    // 去重逻辑，确保同id只保留最新的
                    distinctBy { it.id }
                }
            }
        }
    }
}

//  UI层收集StateFlow
val messages by viewmodel.messages.collectAsStateWithLifecycle()

3. 新增条目去重逻辑 #

修改addNewItem扩展方法，添加前先移除已有同id的条目，避免重复添加：

fun MutableList<Entity>.addNewItem(entity: Entity) {
    // 先移除已存在的同id条目，避免重复
    removeAll { it.id == entity.id }
    if (this.size >= MAX_SIZE) {
        removeLast()
    }
    this.add(0, entity)
}

4. 优化高频率更新场景 #

如果上游会短时间发射大量数据，可以用flow操作符批量处理，减少更新次数：

repo.getData()
    // 缓存100ms内的所有数据，一次性批量添加，避免频繁触发列表更新
    .buffer(100)
    .flowOn(Dispatchers.IO)
    .collect { batch ->
        _messages.addAll(0, batch.distinctBy { it.id })
        // 后续裁剪超过MAX_SIZE的逻辑
    }

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