Jetpack Navigation单导航图多返回栈底部菜单选中状态异常问题

你的问题核心在于：单导航图下，深层Fragment不在底部菜单的匹配ID列表中，导致切换回标签时菜单不高亮；同时你希望避免重复定义Fragment，支持跨标签共享页面。以下是无需为每个标签写独立完整导航图的实现方案：

1. 导航图结构重构：嵌套导航+通用Fragment复用 #

将底部标签对应为嵌套导航图，共享Fragment抽离到单独的通用导航图中，通过<include>引入，既实现多返回栈，又避免重复代码。

步骤1：创建通用导航图（存放共享Fragment） #

新建nav_graph_common.xml，放置所有标签共享的页面：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/nav_graph_common">

    <fragment
        android:id="@+id/DeepFragment"
        android:label="@string/title_deep"
        android:name="com.test.myapplication.ui.notifications.NotificationsFragment2"
        tools:layout="@layout/fragment_notifications" />
</navigation>

步骤2：修改主导航图，拆分嵌套标签导航 #

更新mobile_navigation.xml，每个底部标签对应一个嵌套导航图，并引入通用导航图：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/mobile_navigation"
    app:startDestination="@+id/home_nav_graph">

    <!-- Home标签专属嵌套导航图 -->
    <navigation
        android:id="@+id/home_nav_graph"
        android:label="@string/title_home"
        app:startDestination="@+id/navigation_home">
        <fragment
            android:id="@+id/navigation_home"
            android:label="@string/title_home"
            android:name="com.test.myapplication.ui.home.HomeFragment"
            tools:layout="@layout/fragment_home">
            <!-- 添加从Home到DeepFragment的跳转动作 -->
            <action
                android:id="@+id/action_home_to_deep"
                app:destination="@id/DeepFragment" />
        </fragment>
        <!-- 引入通用导航图 -->
        <include app:graph="@navigation/nav_graph_common" />
    </navigation>

    <!-- Dashboard标签专属嵌套导航图 -->
    <navigation
        android:id="@+id/dashboard_nav_graph"
        android:label="@string/title_dashboard"
        app:startDestination="@+id/navigation_dashboard">
        <fragment
            android:id="@+id/navigation_dashboard"
            android:label="@string/title_dashboard"
            android:name="com.test.myapplication.ui.dashboard.DashboardFragment"
            tools:layout="@layout/fragment_dashboard" />
        <include app:graph="@navigation/nav_graph_common" />
    </navigation>

    <!-- Notification标签专属嵌套导航图 -->
    <navigation
        android:id="@+id/notification_nav_graph"
        android:label="@string/title_notifications"
        app:startDestination="@+id/navigation_notifications">
        <fragment
            android:id="@+id/navigation_notifications"
            android:label="@string/title_notifications"
            android:name="com.test.myapplication.ui.notifications.NotificationsFragment"
            tools:layout="@layout/fragment_notifications">
            <action
                android:id="@+id/action_notification_to_deep"
                app:destination="@id/DeepFragment" />
        </fragment>
        <include app:graph="@navigation/nav_graph_common" />
    </navigation>

</navigation>

2. Activity中配置多返回栈+修复菜单高亮 #

在主Activity中，关联底部导航与导航控制器，同时通过监听导航目的地变化，手动匹配根导航图来高亮对应菜单：

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val navView = findViewById<BottomNavigationView>(R.id.nav_view)
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment_activity_main) as NavHostFragment
        val navController = navHostFragment.navController

        // 配置底部导航与导航控制器，启用多返回栈
        val appBarConfiguration = AppBarConfiguration(
            setOf(
                R.id.home_nav_graph,
                R.id.dashboard_nav_graph,
                R.id.notification_nav_graph
            )
        )
        setupActionBarWithNavController(navController, appBarConfiguration)
        navView.setupWithNavController(navController)

        // 监听导航变化，手动设置底部菜单选中状态
        navController.addOnDestinationChangedListener { _, destination, _ ->
            val rootNavId = findRootNavGraphId(destination)
            navView.menu.findItem(rootNavId)?.isChecked = true
        }
    }

    // 递归查找当前页面所属的根导航图（底部标签对应的嵌套图）
    private fun findRootNavGraphId(destination: NavDestination): Int {
        var currentDest = destination
        while (currentDest.parent !is NavGraph || (currentDest.parent as NavGraph).id != R.id.mobile_navigation) {
            currentDest = currentDest.parent ?: break
        }
        return currentDest.id
    }

    override fun onSupportNavigateUp(): Boolean {
        val navController = findNavController(R.id.nav_host_fragment_activity_main)
        return navController.navigateUp() || super.onSupportNavigateUp()
    }
}

3. 关键优势说明 #

• 多返回栈支持：每个嵌套导航图对应独立的返回栈，切换标签时自动保存/恢复栈状态。
• Fragment复用：通用页面仅定义一次，通过<include>引入所有需要的标签导航图，避免重复代码。
• 跨导航图跳转：从任意页面跳转到其他标签的页面时，直接使用目标Fragment的ID即可，导航控制器会自动切换到对应标签并维护返回栈。

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