RecyclerView中ViewPager滚动后子项销毁的解决方案求助

这是RecyclerView嵌套ViewPager时非常常见的复用冲突问题，核心原因是RecyclerView的ItemView回收机制：当子项滑出屏幕范围后，会被回收复用；而ViewPager默认的缓存页数有限，加上回收过程中没有正确保留状态，就会导致滚回原位置时ViewPager的内容丢失。下面是几个不需要依赖FragmentStatePagerAdapter的解决方案：

1. 调整ViewPager的缓存策略，减少页面销毁 #

ViewPager默认只会缓存当前页面左右各1个页面，我们可以直接设置它缓存所有轮播页面，避免滚动时销毁内部View：

// 在绑定RecyclerView子项时，给ViewPager设置缓存页数为轮播图的总数
viewPager.setOffscreenPageLimit(yourImageList.size());

⚠️ 注意：如果你的轮播图数量特别多（比如超过5张），这个方法可能会占用较多内存，建议根据实际场景调整，比如设置为3-5页，兼顾内存和体验。

2. 自定义PagerAdapter，优化页面的创建与回收逻辑 #

因为不能用Fragment相关的Adapter，我们直接基于基础的PagerAdapter实现，修改destroyItem和instantiateItem的逻辑，避免彻底删除View，而是采用detach/attach的方式复用：

示例代码： #

public class CarouselPagerAdapter extends PagerAdapter {
    private List<Integer> mImageList; // 轮播图数据源
    private SparseArray<View> mCachedViews = new SparseArray<>(); // 缓存已创建的View

    public CarouselPagerAdapter(List<Integer> imageList) {
        mImageList = imageList;
    }

    @Override
    public int getCount() {
        return mImageList == null ? 0 : mImageList.size();
    }

    @Override
    public boolean isViewFromObject(@NonNull View view, @NonNull Object object) {
        return view == object;
    }

    @NonNull
    @Override
    public Object instantiateItem(@NonNull ViewGroup container, int position) {
        View itemView = mCachedViews.get(position);
        if (itemView == null) {
            // 创建新的轮播图ItemView
            itemView = LayoutInflater.from(container.getContext())
                    .inflate(R.layout.item_carousel_image, container, false);
            ImageView imageView = itemView.findViewById(R.id.iv_carousel);
            imageView.setImageResource(mImageList.get(position));
            mCachedViews.put(position, itemView);
        }
        // 确保View没有被其他父容器持有
        if (itemView.getParent() != null) {
            ((ViewGroup) itemView.getParent()).removeView(itemView);
        }
        container.addView(itemView);
        return itemView;
    }

    @Override
    public void destroyItem(@NonNull ViewGroup container, int position, @NonNull Object object) {
        // 不要调用默认的super.destroyItem，而是只detach View，不彻底删除
        container.detachViewFromParent((View) object);
    }
}

3. 在RecyclerView Adapter中保存与恢复ViewPager状态 #

RecyclerView复用ItemView时，会重置View的状态，所以我们需要在回收时保存ViewPager的当前页面位置，绑定的时候再恢复：

步骤1：在ViewHolder中添加状态变量 #

public class MyRecyclerViewHolder extends RecyclerView.ViewHolder {
    ViewPager viewPager;
    int savedPagerPosition = -1; // 保存ViewPager的当前页面位置

    public MyRecyclerViewHolder(@NonNull View itemView) {
        super(itemView);
        viewPager = itemView.findViewById(R.id.view_pager);
    }
}

步骤2：回收时保存状态 #

@Override
public void onViewRecycled(@NonNull MyRecyclerViewHolder holder) {
    super.onViewRecycled(holder);
    // 保存当前ViewPager的选中页
    holder.savedPagerPosition = holder.viewPager.getCurrentItem();
}

步骤3：绑定ViewHolder时恢复状态 #

@Override
public void onBindViewHolder(@NonNull MyRecyclerViewHolder holder, int position) {
    // 获取当前RecyclerView子项的轮播数据源
    List<Integer> imageList = mDataList.get(position).getCarouselImages();
    // 设置ViewPager的Adapter（可以复用Adapter，这里为了清晰每次创建）
    CarouselPagerAdapter pagerAdapter = new CarouselPagerAdapter(imageList);
    holder.viewPager.setAdapter(pagerAdapter);
    // 恢复之前保存的页面位置
    if (holder.savedPagerPosition != -1 && holder.savedPagerPosition < imageList.size()) {
        holder.viewPager.setCurrentItem(holder.savedPagerPosition);
    } else {
        // 默认显示第一页
        holder.viewPager.setCurrentItem(0);
    }
}

额外优化建议 #

• 尽量复用PagerAdapter实例：不要每次onBindViewHolder都创建新的CarouselPagerAdapter，可以在ViewHolder中持有Adapter，只更新数据源，减少对象创建开销。
• 避免ViewPager布局嵌套过深：复杂的布局会加重RecyclerView的回收负担，尽量简化轮播项的布局结构。

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