Jetpack Compose中返回主页后恢复LazyVerticalGrid滚动位置问题

你的方案无效的核心原因是：直接将LazyGridState对象存入ViewModel是错误的。LazyGridState是绑定Compose Composition生命周期的状态对象，当页面被导航离开后，原对象会与Composition解绑，返回主页时会重新创建新的LazyGridState，导致之前的状态完全丢失。

正确的做法是保存滚动的原始数据（第一个可见项的索引和偏移量），而非状态对象本身，再通过这些数据初始化滚动状态。

步骤1：修改ViewModel，保存滚动位置数据 #

class HomeViewModel : ViewModel() {
    private val _firstVisibleItemIndex = mutableStateOf(0)
    val firstVisibleItemIndex: State<Int> = _firstVisibleItemIndex

    private val _firstVisibleItemOffset = mutableStateOf(0)
    val firstVisibleItemOffset: State<Int> = _firstVisibleItemOffset

    fun saveScrollPosition(index: Int, offset: Int) {
        _firstVisibleItemIndex.value = index
        _firstVisibleItemOffset.value = offset
    }
}

步骤2：修改HomeScreen，恢复并监听滚动状态 #

@Composable
fun HomeScreen(
    navController: NavHostController,
    darkTheme: Boolean,
    onThemeUpdated: () -> Unit,
    viewModel: HomeViewModel = viewModel()
) {
    // 用ViewModel保存的位置初始化滚动状态
    val scrollState = rememberLazyGridState(
        initialFirstVisibleItemIndex = viewModel.firstVisibleItemIndex.value,
        initialFirstVisibleItemScrollOffset = viewModel.firstVisibleItemOffset.value
    )

    // 监听滚动变化，实时保存位置到ViewModel
    LaunchedEffect(scrollState) {
        snapshotFlow {
            scrollState.firstVisibleItemIndex to scrollState.firstVisibleItemScrollOffset
        }.distinctUntilChanged().collect { (index, offset) ->
            viewModel.saveScrollPosition(index, offset)
        }
    }

    Scaffold(
        topBar = { TopBar(darkTheme, onThemeUpdated) }
    ) { paddingValues ->
        Box(modifier = Modifier.padding(paddingValues)) {
            LazyVerticalGrid(state = scrollState, columns = GridCells.Fixed(2)) {
                items(featureList) { (imageId, titleId, routeId) ->
                    AppScreenCard(
                        imageId = imageId,
                        titleId = titleId,
                        navController = navController,
                        routeId = routeId
                    )
                }
            }
        }
    }
}

关键说明 #

1. 保存原始数据：将滚动位置拆解为firstVisibleItemIndex（第一个可见项索引）和firstVisibleItemScrollOffset（该项的滚动偏移），这两个是基础数据类型，可安全存入ViewModel并持久化状态。
2. 初始化恢复：通过rememberLazyGridState的参数传入保存的初始值，确保页面重组时直接恢复到之前的滚动位置。
3. 实时监听：用snapshotFlow监听滚动状态变化，配合distinctUntilChanged避免不必要的重复保存，只在位置真正改变时更新ViewModel数据。

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