如何替换FragmentStateAdapter中指定Fragment，保留侧边Tab正常跳转功能

首先明确两种不推荐的做法：

• 直接销毁ViewPager2替换为目标Fragment：会破坏现有Tab和ViewPager2的联动逻辑，后续点击Tab无法正常切换页面，完全不需要这么做
• 直接修改原有Adapter中存储的Fragment实例列表不做后续处理：FragmentStateAdapter默认不会主动感知列表变化，而且提前存储所有Fragment实例的写法本身不符合设计规范，容易引发内存泄漏和状态异常

推荐方案：改造Adapter支持动态更新指定位置的Fragment，通过组件通信触发替换操作，完全保留原有Tab交互逻辑。

步骤1：改造HomeTabAdapter #

你原有Adapter的实现存在设计问题，不要提前创建所有Fragment实例存储，改为存储Fragment的类信息按需创建，同时新增替换指定位置Fragment的方法，必须重写getItemId和containsItem保证刷新生效：

public class HomeTabAdapter extends FragmentStateAdapter {
    private final List<Class<? extends Fragment>> fragmentClasses;
    private int replacePosition = -1;
    private Fragment replaceFragment;

    public HomeTabAdapter(@NonNull FragmentManager fragmentManager, @NonNull Lifecycle lifecycle) {
        super(fragmentManager, lifecycle);
        // 只存Fragment类信息，需要的时候再创建实例
        fragmentClasses = Arrays.asList(
                HomeFragment.class,
                PurposeOfVisitFragment.class,
                GalleryFragment.class,
                EscortFragment.class,
                MapsFragment.class,
                FaqFragment.class,
                SupportFragment.class
        );
    }

    // 提供替换指定位置Fragment的方法
    public void replaceFragmentAt(int position, Fragment newFragment) {
        this.replacePosition = position;
        this.replaceFragment = newFragment;
        notifyItemChanged(position);
    }

    // 可选：重置指定位置为原始Fragment，用于切Tab后恢复原有逻辑
    public void resetFragmentAt(int position) {
        if (replacePosition == position) {
            this.replacePosition = -1;
            this.replaceFragment = null;
            notifyItemChanged(position);
        }
    }

    @NonNull
    @Override
    public Fragment createFragment(int position) {
        // 如果当前位置是要替换的位置，返回替换后的Fragment
        if (replacePosition == position && replaceFragment != null) {
            return replaceFragment;
        }
        try {
            return fragmentClasses.get(position).newInstance();
        } catch (IllegalAccessException | InstantiationException e) {
            throw new RuntimeException("Failed to create fragment instance", e);
        }
    }

    @Override
    public int getItemCount() {
        return fragmentClasses.size();
    }

    // 必须重写这两个方法，否则notifyItemChanged不会触发Fragment重建
    @Override
    public long getItemId(int position) {
        if (replacePosition == position) {
            // 替换后的位置返回不同的id，让Adapter感知变化
            return fragmentClasses.size() + position;
        }
        return position;
    }

    @Override
    public boolean containsItem(long itemId) {
        return itemId < fragmentClasses.size() || (itemId >= fragmentClasses.size() && itemId < fragmentClasses.size() * 2);
    }
}

步骤2：定义通信接口实现事件传递 #

需要在EscortFragment中触发外层MainFragment的操作，通过接口回调实现低耦合通信：
首先定义回调接口：

public interface OnReplaceFragmentListener {
    void replaceEscortFragment(Fragment newFragment);
}

在外层MainFragment中实现该接口：

public class MainFragment extends Fragment implements OnReplaceFragmentListener {
    private HomeTabAdapter adapter;
    // EscortFragment在Adapter列表中的固定下标
    private static final int ESCORT_POSITION = 3;

    // 其他初始化逻辑省略，正常初始化ViewPager2和HomeTabAdapter即可

    @Override
    public void replaceEscortFragment(Fragment newFragment) {
        adapter.replaceFragmentAt(ESCORT_POSITION, newFragment);
    }

    // 可选：如果要求点击Tab时恢复为原始EscortFragment，添加Tab选中监听
    private void initTabListener() {
        tabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
            @Override
            public void onTabSelected(TabLayout.Tab tab) {
                int position = tab.getPosition();
                if (position == ESCORT_POSITION) {
                    adapter.resetFragmentAt(ESCORT_POSITION);
                }
                viewPager2.setCurrentItem(position);
            }
            @Override
            public void onTabUnselected(TabLayout.Tab tab) {}
            @Override
            public void onTabReselected(TabLayout.Tab tab) {}
        });
    }
}

步骤3：处理EscortFragment按钮点击逻辑 #

在EscortFragment中绑定回调，触发替换操作：

public class EscortFragment extends Fragment {
    private OnReplaceFragmentListener listener;

    @Override
    public void onAttach(@NonNull Context context) {
        super.onAttach(context);
        // 获取父Fragment的回调实现
        if (getParentFragment() instanceof OnReplaceFragmentListener) {
            listener = (OnReplaceFragmentListener) getParentFragment();
        }
    }

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        Button targetBtn = view.findViewById(R.id你的按钮id);
        targetBtn.setOnClickListener(v -> {
            if (listener != null) {
                // 创建你要替换的目标Fragment实例
                TargetFragment targetFragment = new TargetFragment();
                listener.replaceEscortFragment(targetFragment);
            }
        });
    }

    @Override
    public void onDetach() {
        super.onDetach();
        listener = null;
    }
}

补充说明 #

如果不需要点击Tab时恢复原始EscortFragment，删除resetFragmentAt相关逻辑即可，替换后的Fragment会一直保留在对应Tab位置，不影响其他Tab的正常跳转。

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