Navigation组件中Fragment自定义向上导航行为的实现问题

这个问题我之前也碰到过，核心原因是Navigation组件默认接管了Toolbar的向上导航事件：当你用NavigationUI.setupActionBarWithNavController或setupWithNavController关联Toolbar和NavController时，向上按钮（android.R.id.home）的点击会被NavigationUI直接处理，不会传递到Fragment的onOptionsItemSelected或onSupportNavigateUp；而且向上导航默认触发的是navigateUp()方法，而非返回键的onBackPressed()流程，所以你注册的OnBackPressedCallback只对物理返回键生效。

下面给你几个可行的解决方案，按需选择：

方案一：让向上导航复用返回键的OnBackPressedCallback逻辑 #

如果你希望向上导航和返回键完全共享同一套处理逻辑，可以在Activity中重写onSupportNavigateUp()，把事件转发给onBackPressedDispatcher：

override fun onSupportNavigateUp(): Boolean {
    // 直接触发返回键的回调流程
    onBackPressedDispatcher.onBackPressed()
    return true
}

如果只想让特定Fragment生效，可以先判断当前显示的Fragment：

override fun onSupportNavigateUp(): Boolean {
    val currentFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment)
        ?.childFragmentManager?.fragments?.firstOrNull()
    
    // 仅当当前是目标Fragment时，自定义处理
    if (currentFragment is YourTargetFragment) {
        onBackPressedDispatcher.onBackPressed()
        return true
    }
    // 其他页面交给Navigation默认处理
    return NavigationUI.navigateUp(navController, appBarConfiguration)
}

方案二：在Fragment中直接拦截向上导航事件 #

如果你需要为向上导航单独写逻辑，先确保Activity的菜单事件能传递到Fragment：

第一步：修改Activity的onOptionsItemSelected #

让Navigation处理完未匹配的事件后，传递给Fragment：

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    // 先让Navigation处理菜单事件，未处理的再交给父类（传递给Fragment）
    return NavigationUI.onNavDestinationSelected(item, navController) || super.onOptionsItemSelected(item)
}

第二步：在Fragment中处理向上按钮 #

设置Fragment拥有菜单权限，并重写onOptionsItemSelected：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 告诉Fragment要处理菜单事件
    setHasOptionsMenu(true)
}

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    if (item.itemId == android.R.id.home) {
        // 这里写你的自定义向上导航逻辑
        Log.d("YourFragment", "Toolbar向上按钮被点击")
        // 比如调用你注册的OnBackPressedCallback逻辑
        requireActivity().onBackPressedDispatcher.onBackPressed()
        return true
    }
    return super.onOptionsItemSelected(item)
}

方案三：动态配置Toolbar的向上导航行为 #

通过Navigation的OnDestinationChangedListener，在进入目标Fragment时自定义Toolbar的点击事件：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    val navController = findNavController()
    navController.addOnDestinationChangedListener { _, destination, _ ->
        if (destination.id == R.id.your_fragment_id) {
            // 获取Activity中的Toolbar
            val toolbar = requireActivity().findViewById<Toolbar>(R.id.toolbar)
            // 替换向上按钮的点击事件
            toolbar.setNavigationOnClickListener {
                // 自定义处理逻辑
                requireActivity().onBackPressedDispatcher.onBackPressed()
            }
        }
    }
}

最后再确认下你的OnBackPressedCallback注册是否正确（确保第一个参数是Fragment，这样Fragment销毁时会自动取消注册）：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val callback = object : OnBackPressedCallback(true) {
        override fun handleOnBackPressed() {
            // 你的自定义返回/向上逻辑
            Log.d("YourFragment", "返回键或向上导航被触发")
            // 如果需要执行默认返回行为，先移除回调再调用onBackPressed
            // remove()
            // requireActivity().onBackPressed()
        }
    }
    // 把回调绑定到Fragment的生命周期
    requireActivity().onBackPressedDispatcher.addCallback(this, callback)
}

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