Android中BottomNavigationView搭配NavHostFragment不显示Fragment排查

问题原因与解决方案 #

1. 缺失NavHostFragment核心配置 #

你的FragmentContainerView中未配置app:defaultNavHost="true"属性，该属性用于标识当前NavHostFragment为默认导航宿主，缺少时会导致导航初始化异常，补充配置即可：

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/nav_host_fragment"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layout_constraintBottom_toTopOf="@+id/bottomMenu"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:navGraph="@navigation/staging_home_nav_graph"
    app:defaultNavHost="true" /> <!-- 新增这行配置 -->

2. NavController获取方式错误 #

在父Fragment中嵌套使用NavHostFragment时，不能直接通过Navigation.findNavController()绑定FragmentContainerView获取导航控制器，需要通过子Fragment管理器获取NavHostFragment实例再取控制器，否则会因为初始化时序问题拿到空控制器导致页面加载失败：

// 替换原有绑定代码
val navHostFragment = childFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
binding.bottomMenu.setupWithNavController(navController)

注意：绑定逻辑要放在onViewCreated生命周期中执行，不要放在onCreateView里，确保视图完全初始化完成

3. 校验配套配置一致性 #

• 确认staging_home_nav_graph导航图中已配置startDestination属性，指定默认加载的首个目的地Fragment，未配置的话NavHostFragment初始化后无默认内容
• 确认bottom_menu.xml中每个菜单项的android:id，和导航图中对应目的地的android:id完全一致，否则BottomNavigationView无法匹配到对应导航页面

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