使用BottomNavigationView搭配新NavController时，如何保留Fragment存活状态？

这个问题其实是Navigation组件的默认行为导致的——当用NavigationUI.setupWithNavController绑定BottomNavigationView时，每次切换Tab都会触发Fragment的替换操作（replace），旧Fragment会被销毁，新Fragment重新创建。要让Fragment保持存活，有两种常用的解决方案，看你的需求来选：

方法一：用ViewPager2 + BottomNavigationView（适合简单底部导航场景） #

如果你的底部Tab只是独立的Fragment，不需要复杂的嵌套导航栈，这种方法最简单直接。ViewPager2可以通过预加载机制让Fragment保持存活，切换时只执行onPause/onResume，不会销毁重建。

步骤1：修改布局文件 #

替换原来的NavHostFragment为ViewPager2，和BottomNavigationView组合：

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <androidx.viewpager2.widget.ViewPager2
        android:id="@+id/main_view_pager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"/>

    <com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/bottom_nav"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="?android:attr/windowBackground"
        app:menu="@menu/bottom_nav_menu"/>
</LinearLayout>

步骤2：实现FragmentStateAdapter并关联控件 #

在Activity中初始化ViewPager2，设置预加载数量，同时关联BottomNavigationView的选中事件：

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

        val viewPager = findViewById<ViewPager2>(R.id.main_view_pager)
        val bottomNav = findViewById<BottomNavigationView>(R.id.bottom_nav)

        // 初始化ViewPager的Adapter
        viewPager.adapter = object : FragmentStateAdapter(this) {
            override fun getItemCount(): Int = 3 // 你的Tab数量

            override fun createFragment(position: Int): Fragment {
                return when(position) {
                    0 -> HomeFragment()
                    1 -> DashboardFragment()
                    2 -> NotificationsFragment()
                    else -> HomeFragment()
                }
            }
        }

        // 设置预加载页面数，等于Tab总数-1，确保所有Fragment都不会被销毁
        viewPager.offscreenPageLimit = 2

        // BottomNavigation切换时同步ViewPager
        bottomNav.setOnItemSelectedListener { menuItem ->
            when(menuItem.itemId) {
                R.id.nav_home -> viewPager.currentItem = 0
                R.id.nav_dashboard -> viewPager.currentItem = 1
                R.id.nav_notifications -> viewPager.currentItem = 2
            }
            true
        }

        // ViewPager切换时同步BottomNavigation选中状态
        viewPager.registerOnPageChangeCallback(object : ViewPager2.OnPageChangeCallback() {
            override fun onPageSelected(position: Int) {
                super.onPageSelected(position)
                val targetItem = when(position) {
                    0 -> bottomNav.menu.findItem(R.id.nav_home)
                    1 -> bottomNav.menu.findItem(R.id.nav_dashboard)
                    2 -> bottomNav.menu.findItem(R.id.nav_notifications)
                    else -> bottomNav.menu.findItem(R.id.nav_home)
                }
                targetItem.isChecked = true
            }
        })
    }
}

方法二：自定义FragmentNavigator（保留Navigation导航栈场景） #

如果你的每个Tab里还有嵌套的导航页面（比如从HomeFragment跳转到详情页），需要保留Navigation组件的导航栈功能，可以通过自定义FragmentNavigator来修改默认的替换逻辑，改成hide/showFragment，避免销毁。

步骤1：创建自定义FragmentNavigator #

重写navigate方法，把默认的replace操作改成hide当前Fragment、show目标Fragment：

class KeepAliveFragmentNavigator(
    context: Context,
    fragmentManager: FragmentManager,
    containerId: Int
) : FragmentNavigator(context, fragmentManager, containerId) {

    override fun navigate(
        destination: Destination,
        args: Bundle?,
        navOptions: NavOptions?,
        navigatorExtras: Navigator.Extras?
    ): NavDestination? {
        val tag = destination.id.toString()
        val transaction = fragmentManager.beginTransaction()

        val currentFragment = fragmentManager.primaryNavigationFragment
        currentFragment?.let { transaction.hide(it) }

        var targetFragment = fragmentManager.findFragmentByTag(tag)
        if (targetFragment == null) {
            targetFragment = destination.createFragment(args)
            transaction.add(containerId, targetFragment, tag)
        } else {
            transaction.show(targetFragment)
        }

        transaction.setPrimaryNavigationFragment(targetFragment)
        transaction.setReorderingAllowed(true)
        transaction.commit()

        return destination
    }
}

步骤2：自定义NavHostFragment注册自定义Navigator #

创建自定义的NavHostFragment，替换默认的FragmentNavigator：

class KeepAliveNavHostFragment : NavHostFragment() {
    override fun onCreateNavController(navController: NavController) {
        super.onCreateNavController(navController)
        // 注册自定义的FragmentNavigator
        navController.navigatorProvider.addNavigator(
            KeepAliveFragmentNavigator(
                requireContext(),
                childFragmentManager,
                id
            )
        )
    }
}

步骤3：修改布局中的NavHostFragment #

把原来的androidx.navigation.fragment.NavHostFragment替换成你自定义的：

<fragment
    android:id="@+id/nav_host_fragment"
    android:name="com.yourpackage.KeepAliveNavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_weight="1"
    app:navGraph="@navigation/mobile_navigation"/>

步骤4：正常绑定BottomNavigationView #

之后你还是可以用原来的代码绑定，切换时Fragment就会被隐藏/显示，而不是销毁：

val bottomNavigation = findViewById<BottomNavigationView>(R.id.bottom_nav)
val navController = findNavController(R.id.nav_host_fragment)
NavigationUI.setupWithNavController(bottomNavigation, navController)

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