Navigation Controller无法返回：Fragment同时显示问题排查

问题现象 #

• Fragment A 可正常跳转至 Fragment B，但 Fragment B 无法返回至 Fragment A，调用 navController.popBackStack()、navigateUp() 等导航方法均无效果
• 点击 Fragment B 的返回按钮能触发回调，但导航操作未生效
• 采用自定义 BaseToolbarFragment 替代原生 Toolbar，Activity 中同时显示该 Toolbar Fragment 和 NavHostFragment

核心问题定位 #

1. 导航图跳转目标ID错误：Fragment A 的跳转 action 目标指向了不存在的 @id/fragment，而非正确的 @id/fragmentB，导致导航栈结构异常
2. BackPressed 回调未正确关联导航逻辑：Fragment B 中的回调未有效调用 NavController 的返回方法，且自定义 Toolbar 的返回逻辑依赖 Activity 的 BackPressedDispatcher，可能与 NavHost 的默认返回处理冲突
3. Fragment 与 Activity 耦合度过高：Fragment 直接调用 Activity 方法配置 Toolbar，增加了依赖且易导致状态不同步

修复步骤 #

1. 修正导航图跳转目标 #

打开 nav_graph.xml，将 Fragment A 的 action 目标改为正确的 fragmentB：

<fragment
    android:id="@+id/fragmentA"
    android:name="com.example.linearprogramming.framework.view.fragment.FragmentA"
    android:label="FragmentA"
    tools:layout="@layout/fragment_a">
    <action
        android:id="@+id/action_from_fragment_a_to_fragment_b"
        app:destination="@id/fragmentB" /> <!-- 修正目标ID -->
</fragment>

2. 正确处理 Fragment B 的返回回调 #

在 Fragment B 的 onViewCreated 中，修改 BackPressed 回调逻辑，确保调用 NavController 的返回方法并绑定生命周期：

requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner) {
    Toast.makeText(requireContext(), "Back from Define Problem fragment", Toast.LENGTH_SHORT).show()
    // 尝试弹出栈，若栈为空则关闭Activity
    if (!navController.popBackStack()) {
        requireActivity().finish()
    }
}

3. 优化自定义 Toolbar 的返回逻辑 #

在 BaseToolbarFragment 中，直接获取 NavHostFragment 的 NavController 处理返回，避免依赖 Activity 的 BackPressedDispatcher：

private fun setUpViews() {
    binding.backButton.setOnClickListener {
        val navHostFragment = requireActivity().supportFragmentManager.findFragmentById(R.id.fragment_container_view) as NavHostFragment
        val navController = navHostFragment.navController
        if (!navController.popBackStack()) {
            requireActivity().finish()
        }
    }
}

4. 解耦 Toolbar 配置逻辑（可选优化） #

在 MainActivity 中通过 Navigation 的 OnDestinationChangedListener 自动配置 Toolbar，避免 Fragment 直接调用 Activity 方法：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(binding.root)

    initializeToolbar()
    setupNavigationToolbarListener()
}

private fun setupNavigationToolbarListener() {
    val navHostFragment = supportFragmentManager.findFragmentById(R.id.fragment_container_view) as NavHostFragment
    val navController = navHostFragment.navController
    navController.addOnDestinationChangedListener { _, destination, _ ->
        when (destination.id) {
            R.id.fragmentA -> viewmodel.setBaseToolbar(resources.getString(R.string.toolbar_fragment_a_title))
            R.id.fragmentB -> viewmodel.setBaseToolbar(resources.getString(R.string.toolbar_fragment_b_title), true)
        }
    }
}

之后可删除 Fragment A 和 B 中的 setUpToolbar 方法，降低耦合度。

验证方法 #

在 Fragment B 的 onViewCreated 中添加日志，确认导航栈状态：

val backStackCount = navController.backStack.size
Log.d("NavDebug", "Back stack count: $backStackCount")
navController.backStack.forEach { entry ->
    Log.d("NavDebug", "Stack entry: ${entry.destination.label}")
}

若日志显示 Fragment A 在栈中，说明导航结构正常，修复生效。

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