ViewPager2首个Tab内嵌RecyclerView首次加载不显示条目问题求助

问题根因 #

你遇到的首次加载不渲染、切Tab后才显示的问题，由以下几个常见的嵌套Fragment+ViewPager2的开发错误导致：

1. LinearLayoutManager初始化时机错误：你在类属性定义阶段直接用getActivity()初始化LayoutManager，此时Fragment尚未绑定到Activity，getActivity()返回空，导致RecyclerView首次加载时没有有效的布局管理器，无法渲染条目；切走再切回时Fragment已完成绑定，LayoutManager才生效。
2. 适配器初始化时机错误：你在数据加载完成后才为RecyclerView设置适配器，如果数据加载完成早于onCreateView执行，设置适配器时RecyclerView还未完成初始化，不会触发首次渲染。
3. ViewPager2适配器复用Fragment实例的问题：你预先创建了3个Fragment实例存在列表中返回，嵌套Fragment场景下会出现生命周期不同步，导致视图渲染逻辑执行异常。

修复方案 #

1. 调整RecyclerView相关初始化逻辑 #

修改ShopServicesCategories类的代码：

// 类属性保留这些定义即可，不要提前初始化LayoutManager
RecyclerView rv;
List<SubSectionModel> mData = new ArrayList<>();
SubSectionAdapter mAdapter;

// onCreateView中完成所有视图初始化
@Override
public View onCreateView(@NonNull LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.your_fragment_layout, container, false);
    rv = view.findViewById(R.id.shop_sservice_cat_rv);
    // 在这里初始化LayoutManager，用requireContext()保证上下文非空
    LinearLayoutManager llm = new LinearLayoutManager(requireContext());
    rv.setLayoutManager(llm);
    // 提前初始化适配器，先绑定空数据
    mAdapter = new SubSectionAdapter(requireContext(), mData, new SubSectionAdapter.OnItemClickListener() {
        @Override
        public void onItemClick(SubSectionModel subSectionModel) {
            Log.i("click",subSectionModel.getSub()+" "+subSectionModel.getHave_sub_sec());
            openSubSec(subSectionModel.getSub());
        }
    });
    rv.setAdapter(mAdapter);
    // 在这里执行你的数据加载逻辑
    loadData();
    return view;
}

// 数据加载完成后调用该方法更新数据，不要重复创建适配器
private void updateRecyclerViewData(List<SubSectionModel> newData) {
    mData.clear();
    mData.addAll(newData);
    mAdapter.notifyDataSetChanged();
}

同时你需要在SubSectionAdapter中补充接收列表数据的逻辑，确保数据更新后能触发重绘。

2. 调整ViewPager2适配器逻辑 #

不要预先创建Fragment实例，在createFragment方法中实时生成实例，避免生命周期同步问题：

public class ShopMenuTabAdapter extends FragmentStateAdapter {

    public ShopMenuTabAdapter(@NonNull FragmentActivity fragmentActivity) {
        super(fragmentActivity);
    }

    @NonNull
    @Override
    public Fragment createFragment(int position) {
        switch (position){
            case 0:
                return new ShopServicesCategories();
            case 1:
                return new ShopReview();
            case 2:
                return new ShopAbout();
            default:
                throw new IllegalArgumentException("无效的Tab位置");
        }
    }

    @Override
    public int getItemCount() {
        return 3;
    }
}

3. 可选优化：关闭ViewPager2懒加载 #

如果需要提前加载所有Tab的内容，避免切换时的加载延迟，可以给ViewPager2设置离屏加载限制：

viewPager2.setOffscreenPageLimit(3);

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