如何让Navigation Component中每个Fragment始终仅保留一个实例

项目背景 #

• 采用Kotlin语言的单Activity+Fragment架构
• 结合使用Navigation Component与BottomNavigationView
• 底部导航栏包含4个标签页（对应4个Fragment）

遇到的问题 #

切换底部导航标签时，每个Fragment都会被重新创建，引发应用卡顿，需求是让每个Fragment始终仅存在一个实例。

已尝试的无效方案 #

• 在graph.xml中为标签Fragment添加app:launchSingleTop="true"，无效果
• 通过回退栈判断复用Fragment的逻辑仅偶尔生效（推测是回退栈被清空导致），代码如下：

binding.bottomNavigationView.setOnItemSelectedListener { item: MenuItem ->

      if (!navController.popBackStack(item.itemId, false)) {
          NavigationUI.onNavDestinationSelected(item , navController)

      }
      true
  }

• 使用navController.navigate(item.itemId, null, NavOptions.Builder().setPopUpTo(item.itemId, false).build())替代NavigationUI.onNavDestinationSelected，仍然无效

可行解决方案 #

方案1：手动管理Fragment实例（稳定性最高） #

放弃Navigation Component自动管理BottomNavigation的逻辑，改用FragmentManager直接维护Fragment实例，切换时仅做隐藏/显示操作，彻底避免重建。

实现步骤：

1. 替换布局中的NavHostFragment为普通的FragmentContainerView或FrameLayout作为容器：

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/fragment_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2. 在Activity中初始化4个Fragment的懒加载单例：

private val homeFragment by lazy { HomeFragment() }
private val discoverFragment by lazy { DiscoverFragment() }
private val messageFragment by lazy { MessageFragment() }
private val mineFragment by lazy { MineFragment() }
private var currentFragment: Fragment? = null

3. 设置BottomNavigationView的选中监听，通过事务切换Fragment：

binding.bottomNavigationView.setOnItemSelectedListener { item ->
    val targetFragment = when(item.itemId) {
        R.id.nav_home -> homeFragment
        R.id.nav_discover -> discoverFragment
        R.id.nav_message -> messageFragment
        R.id.nav_mine -> mineFragment
        else -> homeFragment
    }

    supportFragmentManager.beginTransaction().apply {
        currentFragment?.let { hide(it) }
        if (!targetFragment.isAdded) {
            add(R.id.fragment_container, targetFragment)
        } else {
            show(targetFragment)
        }
        commit()
    }
    currentFragment = targetFragment
    true
}

4. 启动时默认加载第一个Fragment：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    binding = ActivityMainBinding.inflate(layoutInflater)
    setContentView(binding.root)

    // 初始化显示首页
    supportFragmentManager.beginTransaction()
        .add(R.id.fragment_container, homeFragment)
        .commit()
    currentFragment = homeFragment
}

方案2：调整Navigation Component的回退栈策略（适合坚持用Navigation的场景） #

如果必须保留Navigation Component，需要修正setPopUpTo的配置，确保切换时保留目标Fragment实例：

binding.bottomNavigationView.setOnItemSelectedListener { item ->
    val navOptions = NavOptions.Builder()
        // 回退到导航图的起始页，但不清栈，保留目标Fragment实例
        .setPopUpTo(navController.graph.startDestinationId, false)
        .setLaunchSingleTop(true)
        .build()
    navController.navigate(item.itemId, null, navOptions)
    true
}

同时需确保：

• graph.xml中每个Fragment的android:id与BottomNavigationView的menu item id完全一致
• 导航图中不要给Fragment的action设置app:popUpTo属性

注意：这种方式仍可能在某些边界场景下触发Fragment重建，稳定性不如手动管理方案。

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