Android RecyclerView滚动位置恢复失效问题求助

可能的原因及对应解决方法 #

1. 数据更新与滚动操作顺序错误 #

若返回后先执行滚动、再更新Adapter数据，RecyclerView此时无有效数据，滚动会失效。必须先更新数据并通知刷新，再执行滚动：

// 先更新Adapter数据并触发刷新
itemAdapter.DoSetDataList(newItemList);
itemAdapter.notifyDataSetChanged();

// 再执行滚动操作
LinearLayoutManager linearLayoutManager = (LinearLayoutManager) Tree.DerRecycler.getLayoutManager();
if (linearLayoutManager != null) {
    linearLayoutManager.scrollToPosition(lastScrollPos);
}

2. scrollToPosition无法精确对齐顶部 #

scrollToPosition仅保证目标Item可见，不会强制对齐RecyclerView顶部。若需精确恢复位置，需同时记录Item的顶部偏移量，使用scrollToPositionWithOffset：

• 记录位置时：

LinearLayoutManager linearLayoutManager = (LinearLayoutManager) Tree.DerRecycler.getLayoutManager();
if (linearLayoutManager != null) {
    scrollPos = linearLayoutManager.findFirstVisibleItemPosition();
    // 记录Item顶部到RecyclerView顶部的偏移量
    View firstVisibleView = linearLayoutManager.findViewByPosition(scrollPos);
    if (firstVisibleView != null) {
        scrollOffset = firstVisibleView.getTop();
    }
}

• 恢复位置时：

LinearLayoutManager linearLayoutManager = (LinearLayoutManager) Tree.DerRecycler.getLayoutManager();
if (linearLayoutManager != null) {
    linearLayoutManager.scrollToPositionWithOffset(lastScrollPos, lastScrollOffset);
}

3. 滚动操作未在主线程执行 #

RecyclerView滚动必须在主线程执行，若在子线程调用，需切换到主线程：

runOnUiThread(() -> {
    Tree.DerRecycler.scrollToPosition(lastScrollPos);
});

4. Adapter/LayoutManager被重新实例化 #

若返回后重新创建了Adapter或LinearLayoutManager实例，之前记录的位置会失效。检查代码，确保复用原Adapter和LayoutManager实例，避免重复初始化。

5. RecyclerView未完成布局测量 #

若滚动操作在RecyclerView布局完成前执行，会无效果。可在布局完成回调中执行滚动：

Tree.DerRecycler.addOnLayoutChangeListener(new View.OnLayoutChangeListener() {
    @Override
    public void onLayoutChange(View v, int left, int top, int right, int bottom, int oldLeft, int oldTop, int oldRight, int oldBottom) {
        Tree.DerRecycler.removeOnLayoutChangeListener(this); // 仅执行一次
        Tree.DerRecycler.scrollToPosition(lastScrollPos);
    }
});

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