Fragment转场重叠问题：从RecyclerView Adapter替换Fragment出现叠加

Fragment叠加显示的核心问题不是需要销毁当前Fragment或RecyclerView数据，而是你可能在执行Fragment替换时用错了事务方法，或者没有遵循导航逻辑的最佳实践。下面是具体的排查和解决步骤：

1. 先排查Fragment事务的核心错误 #

最常见的叠加原因是用了add()而非replace()，或者指定了错误的容器ID：

• add()会把新Fragment直接叠加在旧Fragment之上，而replace()会先移除容器内的旧Fragment，再添加新的
• 一定要确保你替换的是宿主布局中专门用于承载Fragment的FrameLayout ID，而不是RecyclerView或其他视图的ID

如果一定要在Adapter里临时处理（不推荐，后面说最佳实践），可以这样写事务：

holder.itemView.setOnClickListener(v -> {
    // 先把Context转成Activity，获取FragmentManager
    FragmentActivity activity = (FragmentActivity) context;
    Fragment newFragment = new YourTargetFragment();
    FragmentTransaction transaction = activity.getSupportFragmentManager().beginTransaction();
    
    // 关键：用replace，并且传入正确的容器ID
    transaction.replace(R.id.your_fragment_container_id, newFragment);
    // 如果需要返回上一页，添加到回退栈
    transaction.addToBackStack(null);
    transaction.commit();
});

2. 最佳实践：不要在Adapter里处理Fragment导航 #

Adapter的职责应该只限于数据绑定和UI展示，Fragment替换这种导航逻辑应该交给宿主Activity或Fragment。推荐用接口回调的方式解耦：

第一步：在Adapter中定义回调接口 #

public class TouristLocationCategoryAdapter extends RecyclerView.Adapter<TouristLocationCategoryAdapter.TouristLocationCategoryViewHolder> {
    private Context context;
    private List<TouristCategory> categoryList;
    private OnCategorySelectListener onCategorySelectListener;

    // 定义回调接口
    public interface OnCategorySelectListener {
        void onCategorySelected(TouristCategory category);
    }

    // 构造方法传入回调
    public TouristLocationCategoryAdapter(Context context, List<TouristCategory> categoryList, OnCategorySelectListener listener) {
        this.context = context;
        this.categoryList = categoryList;
        this.onCategorySelectListener = listener;
    }

    @Override
    public void onBindViewHolder(@NonNull TouristLocationCategoryViewHolder holder, int position) {
        TouristCategory category = categoryList.get(position);
        // 绑定数据...
        
        // 点击时触发回调
        holder.itemView.setOnClickListener(v -> {
            if (onCategorySelectListener != null) {
                onCategorySelectListener.onCategorySelected(category);
            }
        });
    }

    // ViewHolder类...
    public static class TouristLocationCategoryViewHolder extends RecyclerView.ViewHolder {
        // 控件定义...
        public TouristLocationCategoryViewHolder(@NonNull View itemView) {
            super(itemView);
            // 初始化控件...
        }
    }
}

第二步：在宿主Fragment/Activity中实现回调，处理导航 #

public class HostFragment extends Fragment implements TouristLocationCategoryAdapter.OnCategorySelectListener {

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_host, container, false);
        RecyclerView rvCategories = view.findViewById(R.id.rv_categories);
        
        // 初始化数据和Adapter，传入回调
        List<TouristCategory> categories = loadCategories();
        TouristLocationCategoryAdapter adapter = new TouristLocationCategoryAdapter(getContext(), categories, this);
        rvCategories.setAdapter(adapter);
        rvCategories.setLayoutManager(new LinearLayoutManager(getContext()));
        
        return view;
    }

    @Override
    public void onCategorySelected(TouristCategory category) {
        // 创建目标Fragment
        TargetFragment targetFragment = TargetFragment.newInstance(category);
        // 执行替换事务
        FragmentTransaction transaction = getParentFragmentManager().beginTransaction();
        transaction.replace(R.id.fragment_container, targetFragment);
        transaction.addToBackStack(null); // 可选，需要返回时添加
        transaction.commit();
    }
}

3. 关于当前Fragment和RecyclerView数据的处理 #

• 当前Fragment：用replace()方法时，系统会自动处理旧Fragment的移除和生命周期回调（比如onDestroyView、onDestroy），不需要你手动销毁它
• RecyclerView数据：RecyclerView属于旧Fragment的视图层，当旧Fragment的视图被销毁后，RecyclerView会被自动回收，它的数据也会跟着释放，不需要你手动清空

常见坑点提醒 #

• 不要在Adapter中持有Fragment的引用，避免内存泄漏
• 如果宿主是Fragment，要使用getParentFragmentManager()（AndroidX）而非getFragmentManager()
• 确保你的Fragment容器是一个空的FrameLayout，没有其他子视图

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