Android NavController+BottomNavBar：如何正确实现程序化导航？

问题场景 #

当前架构：MainActivity通过BottomNavigationView + NavHostFragment管理4个底部页面，点击底部图标切换正常。但在嵌套Fragment中，通过自定义的静态方法MainActivity.navigate()带参数跳转到底部导航页面后，出现两个异常：

1. 底部导航栏仍高亮原页面图标，未同步目标页面选中状态
2. 点击原页面和目标页面的图标，Fragment不再切换；点击另外两个图标仍正常工作

布局代码（activity_main.xml） #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/nav_view"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="0dp"
        android:layout_marginEnd="0dp"
        android:background="?android:attr/windowBackground"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:menu="@menu/bottom_nav_menu"
        tools:ignore="VisualLintBottomNav"
        app:labelVisibilityMode="labeled" />

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/fragmentContainerView"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:defaultNavHost="true"
        app:layout_constraintBottom_toTopOf="@id/nav_view"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:navGraph="@navigation/mobile_navigation" />

</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity代码 #

class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding

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

        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        val navView: BottomNavigationView = binding.navView
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment?
        val navController = navHostFragment!!.navController
        navView.setupWithNavController(navController)
    }

    companion object {
        fun navigate(instance : MainActivity, destination : Int, args : Bundle) {
            val navHostFragment = instance.supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment?
            val navController = navHostFragment!!.navController
            navController.navigate(destination, args)
        }
    }
}

问题根源 #

直接调用navController.navigate(destination, args)会在导航栈中新增一个目标页面的Fragment实例，而非切换到底部导航对应的栈顶页面。BottomNavigationView与NavController绑定后，仅通过栈顶目的地ID同步选中状态：

• 新增实例导致栈顶虽是目标页面，但导航栏未识别到这是底部菜单对应的根实例，因此不更新高亮状态
• 后续点击原页面和目标页面图标时，NavController认为栈中已有对应目的地实例，不会触发页面切换

解决方案 #

方案1：修正静态导航方法，确保跳转到底部导航的根实例 #

修改navigate方法，判断目标是否为底部菜单项，优先切换到已有栈顶实例，而非新增：

companion object {
    fun navigate(instance : MainActivity, destination : Int, args : Bundle) {
        val navHostFragment = instance.supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment?
        val navController = navHostFragment!!.navController
        
        // 判断目标是否属于底部导航菜单
        val bottomNavMenu = instance.binding.navView.menu
        val isBottomNavDest = (0 until bottomNavMenu.size()).any { 
            bottomNavMenu.getItem(it).itemId == destination 
        }

        if (isBottomNavDest) {
            // 先尝试回到目标页面的栈顶，若栈中无该实例再导航
            val popped = navController.popBackStack(destination, false)
            if (!popped) {
                navController.navigate(destination, args)
            }
        } else {
            // 非底部导航页面，正常新增实例
            navController.navigate(destination, args)
        }
    }
}

方案2：使用NavOptions确保单实例跳转 #

在导航时配置NavOptions，强制跳转到底部页面时清除多余栈实例，保留单例：

companion object {
    fun navigate(instance : MainActivity, destination : Int, args : Bundle) {
        val navHostFragment = instance.supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment?
        val navController = navHostFragment!!.navController
        
        val bottomNavMenu = instance.binding.navView.menu
        val isBottomNavDest = (0 until bottomNavMenu.size()).any { 
            bottomNavMenu.getItem(it).itemId == destination 
        }

        val navOptions = if (isBottomNavDest) {
            NavOptions.Builder()
                .setLaunchSingleTop(true) // 确保仅打开一个实例
                .setPopUpTo(destination, false) // 弹出到目标页面的根实例
                .build()
        } else {
            null
        }

        navController.navigate(destination, args, navOptions)
    }
}

方案3：嵌套Fragment直接获取NavController（推荐） #

无需依赖MainActivity的静态方法，嵌套Fragment可直接获取NavController，符合Navigation组件设计：

// 在嵌套Fragment的点击事件中
yourButton.setOnClickListener {
    val args = Bundle().apply {
        putString("param_key", "param_value")
    }
    findNavController().navigate(R.id.target_bottom_fragment, args)
}

同时在导航图中为底部页面设置app:launchSingleTop="true"，避免重复实例化。

关键注意事项 #

• BottomNavigationView与NavController的状态同步完全依赖导航栈的栈顶目的地ID，必须保证底部页面的跳转操作不新增多余实例
• 尽量避免通过静态方法操作Activity的NavController，减少组件耦合，优先使用Fragment自身的findNavController()

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