引入Paging 3库后RecyclerView布局管理器状态恢复失效
问题根因
引入Paging3哪怕未实际使用功能就导致原有LayoutManager状态保存方案失效,核心原因是Paging3的Gradle依赖会传递引入1.3.0及以上版本的RecyclerView库。
高版本RecyclerView对StaggeredGridLayoutManager的状态保存、恢复逻辑做了行为调整:
- 旧版本中,LayoutManager状态仅在RecyclerView自身触发
onSaveInstanceState时才会持久化,恢复流程和View的attach生命周期严格绑定 - 高版本中,系统会自动触发LayoutManager的状态保存与恢复流程,和你之前手写的内存级状态保存逻辑形成时机冲突:你在
onViewStateRestored阶段手动调用恢复逻辑时,RecyclerView已经完成了一轮默认状态的初始化与布局计算,你手动保存的状态会被直接覆盖,甚至触发StaggeredGrid默认的跨列重排逻辑,回到最初的位置错乱问题。
修正方案
- 将原本存在Fragment内存变量中的LayoutManager状态,迁移到系统提供的
SavedInstanceStateBundle中持久化,避免ViewPager缓存销毁、Fragment配置变更导致的状态丢失,从根源上解决内存态方案的可靠性问题 - 调整状态恢复的时机:延后到Adapter完成首次数据绑定、布局计算执行完成之后再触发状态恢复,避免提前恢复的状态被系统的默认布局流程冲掉
- 如果使用Paging3提供的
PagingDataAdapter,利用其内置的页面更新监听回调,定位首屏渲染完成的节点再执行状态恢复,不要在View刚创建完成时就强行套用旧状态
修正后的实现代码
class TestFragment : Fragment() { private val testListAdapter: TestListAdapter by lazy { TestListAdapter() } // 定义状态存储的固定键值 private const val KEY_LM_STATE = "key_staggered_lm_state" override fun onCreateView( inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle? ): View { return inflater.inflate(R.layout.fragment_test, container, false) } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) // 从恢复的Bundle中取出之前持久化的LayoutManager状态 val savedLmState = savedInstanceState?.getParcelable<Parcelable>(KEY_LM_STATE) postListView.apply { layoutManager = StaggeredGridLayoutManager( 2, StaggeredGridLayoutManager.VERTICAL ).apply { gapStrategy = StaggeredGridLayoutManager.GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS } setHasFixedSize(true) adapter = testListAdapter // 监听Adapter的首屏数据更新完成事件 testListAdapter.addOnPagesUpdatedListener { savedLmState?.let { lmState -> // 切到下一帧执行状态恢复,避开当前帧的布局计算流程 post { layoutManager?.onRestoreInstanceState(lmState) } // 恢复完成后移除监听,避免后续数据更新触发不必要的重排 testListAdapter.removeOnPagesUpdatedListener { } } } } } // 在系统要求持久化状态的节点,保存LayoutManager状态到Bundle override fun onSaveInstanceState(outState: Bundle) { super.onSaveInstanceState(outState) postListView.layoutManager?.let { lm -> outState.putParcelable(KEY_LM_STATE, lm.onSaveInstanceState()) } } }
注意事项
- 只要引入Paging3依赖,不管是否使用分页功能,都会自动传递引入新版本RecyclerView,其内置的自动状态恢复、预加载优化逻辑会和旧的手写内存态保存方案产生冲突,这是依赖传递带来的版本变更问题,不是Paging3本身的业务逻辑导致的
- 状态恢复前要保证StaggeredGridLayoutManager的跨列数、gap策略等配置和状态保存时完全一致,否则恢复的滚动坐标会出现偏移
- 不要在
onPause阶段提前读取LayoutManager状态存在内存里,要在系统触发onSaveInstanceState的节点读取,保证拿到的状态是布局稳定后的完整状态
内容的提问来源于stack exchange,提问作者Hadi Ahmadi
相关产品推荐
相关产品推荐

