NavGraph实现BottomNavigation切换Fragment时阻止重复重建

Navigation组件默认的Fragment切换逻辑是替换上一个目的地的视图层级，切换Tab时必然触发上一个Fragment的onDestroyView，切回时重新走onCreateView、onViewCreated生命周期，这是框架的默认设计，不是bug。
你之前写的协程代码无效，是因为launchWhenCreated只绑定生命周期状态，视图重建时生命周期会重新流转到CREATED状态，协程自然会重复触发，完全无法实现单次执行的效果。

从Navigation 2.4.0版本开始，框架已经原生支持底部导航多返回栈状态保存，不需要自定义复杂逻辑，只要做适配即可实现状态留存、避免重复请求：

• 先升级依赖：确保navigation-fragment-ktx、navigation-ui-ktx版本≥2.4.0，配套fragment-ktx版本≥1.5.0，直接用当前最新稳定版即可。
• 基础配置：正常调用NavigationUI.setupWithNavController(bottomNavigationView, navController)绑定底部导航和NavController，框架会自动为每个Tab维护独立返回栈，切换时自动保存Fragment的状态Bundle。
• 业务代码适配：
  • 数据请求逻辑不要直接写在onViewCreated里：把数据加载、缓存逻辑下沉到Fragment对应的ViewModel中，注意ViewModel要绑定Fragment自身的lifecycle（不要绑定viewLifecycleOwner），这样View销毁时ViewModel不会被回收。给接口请求加加载标记，首次请求成功后缓存结果，后续View重建时直接从ViewModel取已有数据即可，不需要重复调用API。
  • UI状态和View解耦：搜索关键词、地图选中点位、列表滚动位置这类状态，要么存在ViewModel中，要么重写onSaveInstanceState把状态写入Bundle，视图重建时从Bundle读取恢复。
  • 针对Google Map这类自带状态的重控件，在onSaveInstanceState回调中调用地图自身的状态保存方法拿到状态Bundle，重建时把Bundle传给地图实例，即可恢复之前的搜索位置、缩放层级、标记点等状态。

这个方案是Jetpack官方推荐的实现方式，框架默认销毁不在前台的Fragment View，本质是内存优化策略，避免多个重View同时占用内存导致OOM。

如果你不想做状态适配，就是要让切换时Fragment的View不被销毁，可以自定义NavHost修改Fragment切换逻辑，用hide/show代替默认的replace操作：

1. 自定义StatefulNavHostFragment，重写Fragment导航逻辑：

class StatefulNavHostFragment : NavHostFragment() {
    override fun createFragmentNavigator(): Navigator<out FragmentNavigator.Destination> {
        return object : FragmentNavigator(requireContext(), childFragmentManager, id) {
            override fun navigate(
                entries: List<NavBackStackEntry>,
                navOptions: NavOptions?,
                navigatorExtras: Navigator.Extras?
            ) {
                val transaction = childFragmentManager.beginTransaction()
                // 隐藏当前显示的Fragment
                childFragmentManager.primaryNavigationFragment?.let { transaction.hide(it) }
                entries.forEach { entry ->
                    val fragTag = entry.id.toString()
                    var targetFrag = childFragmentManager.findFragmentByTag(fragTag)
                    if (targetFrag == null) {
                        targetFrag = (entry.destination as Destination).createFragment(entry.arguments)
                        transaction.add(id, targetFrag, fragTag)
                    } else {
                        transaction.show(targetFrag)
                    }
                    transaction.setPrimaryNavigationFragment(targetFrag)
                }
                transaction.setReorderingAllowed(true).commit()
            }
        }
    }
}

2. 把布局文件中原先声明的NavHostFragment替换为你自定义的StatefulNavHostFragment即可。

• 注意：这个方案会让所有Tab的Fragment视图一直常驻内存，如果Tab较多、包含Map/视频播放器这类重资源控件，很容易触发内存溢出，仅适合Tab数量少、视图逻辑极重的场景使用。

如果要写页面首次进入才执行的一次性逻辑，不要用launchWhenCreated绑定视图生命周期，直接在Fragment的ViewModel里用viewModelScope.launch启动任务即可，这个Scope绑定Fragment自身的生命周期，只要Fragment没有被彻底退出销毁，ViewModel不会重建，任务也不会重复执行。

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