如何在RecyclerView的item点击事件中用Navigation Component跳转至目标Fragment

根本原因 #

你遇到的Fragment重叠问题，核心是手动提交的Fragment事务和Navigation Component维护的回退栈完全独立。NavController调度侧边栏等其他页面跳转时，只会操作自己管辖的Fragment实例，不会感知到你手动添加的详情页，导致两个Fragment同时存在于容器中。

正确实现方案：全链路使用Navigation Component管控跳转 #

完全放弃手动提交Fragment事务的写法，所有跳转统一走Navigation逻辑，即可彻底解决回退栈不同步的问题。

方式1：在Adapter中直接通过ItemView获取NavController（快速实现） #

在RecyclerView列表项的点击回调中，直接用列表项根View调用扩展方法即可，不需要传入Activity/Fragment参数：

// 这里的itemView是当前点击的列表项根布局
findNavController(itemView).navigate(R.id.action_settingsFragment_to_groupUnits)

方式2：将点击事件回调到宿主Fragment处理（更推荐，解耦） #

把导航逻辑放到承载列表的Fragment中处理，Adapter只负责列表渲染，后续维护成本更低：

1. 先在RecyclerView.Adapter中定义点击回调接口

class YourListAdapter(private val onItemClick: (YourItemDataType) -> Unit) : RecyclerView.Adapter<YourViewHolder>() {
    // 在onBindViewHolder中给itemView设置点击事件
    override fun onBindViewHolder(holder: YourViewHolder, position: Int) {
        val item = dataList[position]
        holder.itemView.setOnClickListener {
            onItemClick(item)
        }
    }
}

2. 在宿主Fragment中初始化Adapter时传入回调，在回调中直接调用导航方法

// 宿主Fragment中初始化Adapter
val adapter = YourListAdapter { item ->
    // 直接调用当前Fragment的NavController扩展方法，无需传参
    findNavController().navigate(
        R.id.action_settingsFragment_to_groupUnits,
        // 如需传参可以把item数据塞到Bundle里，推荐用Safe Args插件做类型安全传参
        bundleOf("item_data" to item)
    )
}

额外注意事项 #

• 必须提前在导航图中正确定义对应跳转Action，确认Action的起始目的地是当前承载列表的Fragment，目标目的地是详情Fragment
• 所有页面跳转统一走Navigation的navigate方法，不要混合使用手动Fragment事务，避免再次出现回退栈不同步的问题
• 如需给详情页传递参数，推荐使用Navigation官方的Safe Args插件，可实现类型安全的参数传递，避免手动拼Bundle出错

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