Android多Fragment场景SavedStateHandle保存列表状态失效问题求助

问题根源梳理 #

你当前代码的问题集中在以下几个点：

1. 仅用SavedStateHandle存储了热门电影的列表数据，完全没有存储你需要的列表滚动位置、复选框选中状态两类核心视图状态
2. 数据请求逻辑存在缓存覆盖问题：调用getTrending()时会直接发起网络请求，用新返回的列表覆盖SavedStateHandle中已经缓存的旧数据，相当于之前的存储操作无效
3. 缺少视图状态恢复逻辑：即使你后续补存了状态，也没有在Fragment重建视图时把保存的状态回设给RecyclerView和复选框
4. 如果你用replace方式加载底部导航对应的Fragment，每次切换都会销毁Fragment视图，视图状态没有主动存储的话自然会丢失

解决方案 #

1. 补全状态存储逻辑 #

在ViewModel中新增对应状态的存储/读取方法，每个Fragment的状态要使用独立的key分开存储，以热门页为例：

// 新增常量定义
const val TRENDING_SCROLL_POS = "trending_scroll_pos"
const val TRENDING_SCROLL_OFFSET = "trending_scroll_offset"
const val TRENDING_CHECKED_IDS = "trending_checked_ids"

// ViewModel中新增方法
// 保存滚动位置
fun saveTrendingScrollState(pos: Int, offset: Int) {
    state.set(TRENDING_SCROLL_POS, pos)
    state.set(TRENDING_SCROLL_OFFSET, offset)
}

// 读取滚动位置
fun getTrendingScrollState(): Pair<Int, Int> {
    val pos = state.get<Int>(TRENDING_SCROLL_POS) ?: 0
    val offset = state.get<Int>(TRENDING_SCROLL_OFFSET) ?: 0
    return pos to offset
}

// 保存选中的电影ID集合
fun saveTrendingCheckedIds(ids: Set<Int>) {
    state.set(TRENDING_CHECKED_IDS, ids)
}

// 读取选中的电影ID集合
fun getTrendingCheckedIds(): Set<Int> {
    return state.get<Set<Int>>(TRENDING_CHECKED_IDS) ?: emptySet()
}

2. 修改数据请求逻辑，避免缓存被覆盖 #

修改getTrending()方法，优先读取缓存数据，没有缓存再发起网络请求：

fun getTrending() {
    val cachedList = getTrendingMovies()
    if (cachedList.isNotEmpty()) {
        _moviesTrending.value = cachedList
        return
    }
    viewModelScope.launch {
        val newList = repository.getTrendingMovies()
        _moviesTrending.value = newList
        saveTrendingMovie(newList)
    }
}

3. 实现Fragment侧的状态存/读逻辑 #

• 状态保存：在Fragment的onPause或onDestroyView生命周期中存储当前滚动位置、选中状态

override fun onPause() {
    super.onPause()
    val layoutManager = binding.rvTrending.layoutManager as LinearLayoutManager
    // 保存滚动位置
    val scrollPos = layoutManager.findFirstVisibleItemPosition()
    val offset = binding.rvTrending.getChildAt(0)?.top ?: 0
    viewModel.saveTrendingScrollState(scrollPos, offset)
    // 保存复选框选中状态
    viewModel.saveTrendingCheckedIds(adapter.getCheckedIds())
}

• 状态恢复：在列表数据加载完成后回设状态

viewModel.moviesTrending.observe(viewLifecycleOwner) { list ->
    adapter.submitList(list)
    // 恢复滚动位置
    val (pos, offset) = viewModel.getTrendingScrollState()
    binding.rvTrending.layoutManager?.scrollToPositionWithOffset(pos, offset)
    // 恢复复选框状态
    adapter.setCheckedIds(viewModel.getTrendingCheckedIds())
}

4. 优化底部导航加载逻辑（可选） #

如果你的底部导航切换时使用的是replace加载Fragment，建议改成show/hide方式，Fragment视图不会被销毁，大部分状态可以自动保留，减少手动存储的工作量。

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