Android导航组件结合BottomNavigationView：如何维护Fragment状态及避免返回重建？

这个问题我碰到过好多次了，尤其是当用户从列表页面跳转到详情页，再通过navigateUp()返回时，列表滚动位置丢失、Fragment还被重建，确实挺头疼的。下面给你几个经过实践验证的解决思路：

1. 给BottomNavigation对应的目的地配置正确的启动模式和状态恢复属性 #

首先打开你的导航图（nav_graph.xml），找到BottomNavigation关联的几个Fragment目的地，给它们加上这两个关键属性：

• android:launchMode="singleTop"：确保每次切换到该目的地时，复用已有的Fragment实例，而不是创建新的
• app:restoreState="true"：明确告诉Navigation组件恢复这个目的地之前保存的状态

示例导航图配置代码：

<fragment
    android:id="@+id/homeFragment"
    android:name="com.example.app.HomeFragment"
    android:label="Home"
    android:launchMode="singleTop"
    app:restoreState="true">
    <!-- 你的action跳转配置 -->
</fragment>

2. 手动保存和恢复Fragment的精细状态 #

如果默认的状态恢复不够用（比如需要精准控制RecyclerView的滚动位置），可以在Fragment里手动处理状态的保存与恢复：

• 在onSaveInstanceState()中保存滚动位置：

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    // 假设你的列表是RecyclerView，保存它的滚动位置
    val layoutManager = recyclerView.layoutManager as LinearLayoutManager
    outState.putIntArray("scroll_position", intArrayOf(
        layoutManager.findFirstVisibleItemPosition(),
        layoutManager.findFirstCompletelyVisibleItemPosition()
    ))
}

• 在onViewCreated()中恢复状态：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    savedInstanceState?.let { savedState ->
        val scrollPos = savedState.getIntArray("scroll_position")
        scrollPos?.let { pos ->
            val layoutManager = recyclerView.layoutManager as LinearLayoutManager
            layoutManager.scrollToPositionWithOffset(pos[0], 0)
        }
    }
}

3. 自定义FragmentNavigator，避免Fragment被销毁 #

Navigation Component默认在切换到其他非BottomNavigation目的地时，可能会销毁当前的BottomNavigation Fragment。你可以自定义一个FragmentNavigator，修改它的navigate()方法，让Fragment只被detach而不是destroy，从而完整保留状态：

先写自定义Navigator类：

class KeepStateFragmentNavigator(
    context: Context,
    manager: FragmentManager,
    containerId: Int
) : FragmentNavigator(context, manager, containerId) {

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

        // 处理动画（如果有）
        val enterAnim = navOptions?.enterAnim ?: -1
        val exitAnim = navOptions?.exitAnim ?: -1
        val popEnterAnim = navOptions?.popEnterAnim ?: -1
        val popExitAnim = navOptions?.popExitAnim ?: -1
        if (enterAnim != -1 || exitAnim != -1 || popEnterAnim != -1 || popExitAnim != -1) {
            transaction.setCustomAnimations(
                enterAnim.takeIf { it != -1 } ?: 0,
                exitAnim.takeIf { it != -1 } ?: 0,
                popEnterAnim.takeIf { it != -1 } ?: 0,
                popExitAnim.takeIf { it != -1 } ?: 0
            )
        }

        // 分离当前Fragment而不是销毁
        fragmentManager.primaryNavigationFragment?.let {
            transaction.detach(it)
        }

        // 复用已存在的Fragment，不存在则创建
        var fragment = fragmentManager.findFragmentByTag(tag)
        if (fragment != null) {
            transaction.attach(fragment)
        } else {
            fragment = instantiateFragment(context, fragmentManager, destination.className, args)
            transaction.add(containerId, fragment, tag)
        }

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

        return destination
    }
}

然后在Activity中替换默认的Navigator：

val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navigatorProvider = navHostFragment.navController.navigatorProvider
// 添加自定义Navigator
navigatorProvider.addNavigator(KeepStateFragmentNavigator(this, supportFragmentManager, R.id.nav_host_fragment))
// 重新设置导航图
navHostFragment.navController.setGraph(R.navigation.nav_graph)

4. 精准控制返回栈，避免navigateUp()的不确定性 #

有时候navigateUp()会回到栈顶的任意目的地，可能触发Fragment重建。你可以在详情页返回时，直接指定回到BottomNavigation的目标页面，确保复用已有实例：

// 比如从详情页返回HomeFragment，false表示不包含目标页面本身
findNavController().popBackStack(R.id.homeFragment, false)

这样做能直接回到已存在的Fragment实例，不会触发重建，自然保留了之前的状态。

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