Jetpack Compose：添加Spacer后LazyColumn的rememberLazyListState失效问题

是否属于Bug？ #

在Jetpack Compose 1.3.3版本中，这种情况属于框架的已知局限性。LazyListState默认通过项的索引来恢复滚动位置，当你在列表中新增固定位置的Spacer后，原有列表项的索引会发生偏移，导致状态恢复逻辑计算错误，最终出现滚动位置异常的问题。后续Compose版本（如1.4+）对状态恢复逻辑做了优化，以项的唯一标识而非索引作为参考，但1.3.3版本尚未覆盖这个优化。

是否有额外属性直接解决？ #

Compose 1.3.3中没有内置的属性可以直接修正这个问题，需要通过自定义逻辑来规避。

临时解决办法 #

方案1：给所有项设置唯一Key（优先推荐） #

给Spacer和列表数据项都分配唯一的key，让LazyColumn能基于项的身份而非索引识别内容，从而正确恢复滚动状态：

LazyColumn(
    state = rememberLazyListState()
) {
    // 给顶部Spacer设置唯一Key
    item(key = "top-spacer") {
        Spacer(modifier = Modifier.height(100.dp))
    }
    // 给数据项绑定唯一标识（比如数据的ID）
    items(yourDataList, key = { item -> item.id }) { item ->
        Text(text = item.content)
    }
}

方案2：将Spacer移到LazyColumn外部 #

如果Spacer的位置允许（比如固定在列表顶部/底部），直接用Column包裹Spacer和LazyColumn，这样LazyColumn内部的项结构没有变化，滚动状态自然可以正常保留：

Column(modifier = Modifier.fillMaxSize()) {
    Spacer(modifier = Modifier.height(100.dp))
    LazyColumn(
        modifier = Modifier.weight(1f),
        state = rememberLazyListState()
    ) {
        items(yourDataList) { item ->
            Text(text = item.content)
        }
    }
}

方案3：手动保存并恢复滚动位置 #

如果前两种方案不适用，可以手动保存目标项的唯一标识，页面恢复时滚动到对应位置：

val scrollState = rememberLazyListState()
// 保存目标项的唯一Key
val targetItemKey = rememberSaveable { mutableStateOf<String?>(null) }

// 页面销毁前保存当前可见项的Key
DisposableEffect(Unit) {
    onDispose {
        scrollState.layoutInfo.visibleItemsInfo.firstOrNull()?.let { visibleItem ->
            targetItemKey.value = visibleItem.key?.toString()
        }
    }
}

// 页面恢复后滚动到目标项
LaunchedEffect(targetItemKey.value) {
    targetItemKey.value?.let { key ->
        // 计算目标项在列表中的索引（注意加上Spacer的位置偏移）
        val targetIndex = yourDataList.indexOfFirst { it.id.toString() == key } + 1
        scrollState.scrollToItem(index = targetIndex, scrollOffset = 0)
    }
}

LazyColumn(state = scrollState) {
    item(key = "top-spacer") {
        Spacer(modifier = Modifier.height(100.dp))
    }
    items(yourDataList, key = { it.id }) { item ->
        Text(text = item.content)
    }
}

内容的提问来源于stack exchange，提问作者David Aleksanyan