使用Navigation Component绑定BottomNavigationView时重复创建Fragment问题

问题根因 #

你遇到的是Navigation 2.4+多回退栈的典型异常，核心是默认切换底部导航时非起始目的地不会复用实例，加上Fragment视图绑定逻辑或导航配置异常，导致新View无法替换旧视图。

方案1：复用已有的Fragment实例（推荐） #

前置检查 #

• 确保底部导航菜单每个item的android:id和导航图中对应Fragment的id完全一致，这是setupWithNavController正常工作的基础
• 不要自定义BottomNavigationView.OnItemSelectedListener，默认实现已经适配多回退栈实例复用逻辑

实现步骤 #

1. 导航配置调整：开启launchSingleTop标识，确保同一目的地只创建一个实例，可直接替换默认点击逻辑：

bottomNav?.setOnItemSelectedListener { item ->
    navController.navigate(item.itemId, null, NavOptions.Builder()
        .setLaunchSingleTop(true)
        .setPopUpTo(navController.graph.startDestinationId, false, saveState = true)
        .setRestoreState(true)
        .build())
    true
}

2. Fragment视图缓存：如果需要保留视图状态，在Fragment中缓存根View，避免重复创建：

// 以View Binding为例
private var _binding: FragmentTodosBinding? = null
private val binding get() = _binding!!

override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
    if (_binding == null) {
        // 仅首次创建View时初始化
        _binding = FragmentTodosBinding.inflate(inflater, container, false)
        initViews()
        initObservers()
    }
    return binding.root
}

// 不要在onDestroyView中清空_binding，保留缓存
override fun onDestroy() {
    super.onDestroy()
    // Fragment销毁时再清空绑定，避免内存泄漏
    _binding = null
}

方案2：确保新创建的View正确挂载到视图树 #

如果不需要复用实例，每次切换都要重新加载，可按以下步骤排查修复：

• 检查导航图配置：不要给Todos、Profile这两个一级目的地配置popUpTo、popUpToInclusive属性，避免干扰回退栈逻辑
• 检查Fragment的onCreateView逻辑：不要给根View设置parent，也不要手动把View添加到容器中，LayoutInflater.inflate的第三个参数传false即可，由NavHostFragment负责挂载View
• 升级Navigation版本：2.4.0-beta02是测试版本，存在多回退栈相关的已知bug，升级到2.4.0及以上的稳定版即可解决大部分视图挂载异常问题

遗漏配置排查 #

• 确认你没有在Activity的onSaveInstanceState中手动修改NavController的状态，也没有在重建时重复调用setupWithNavController
• 确认nav_host_fragment使用的是androidx.navigation.fragment.NavHostFragment，没有自定义实现

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