Android Kotlin MVVM中NavHostFragment实现侧边栏跳转异常问题

作为Android Studio新手，我正在开发基于Kotlin MVVM架构的应用，计划通过NavHostFragment实现Navigation Drawer功能。已定义包含嵌套导航图的导航布局，希望点击侧边栏图标时能跳转到对应的Fragment，但当前代码无法实现该跳转效果；尝试在点击图标时修改startDestination，会导致应用运行时崩溃。请问如何通过NavHostFragment正确实现该需求？

当前代码存在三个核心问题：

• NavController获取错误：在CentralNavigationFragment中直接调用findNavController()，获取的是当前宿主Fragment的导航控制器，而非nav_host_fragment内部的目标导航控制器。
• 嵌套导航图跳转方式错误：直接跳转嵌套导航图的ID（如R.id.home_navigation）无效，需跳转到导航图的起始目标Fragment；同时手动写when分支容易出现ID匹配错误。
• 修改startDestination导致崩溃：导航组件不支持运行时动态修改已加载导航图的startDestination，强制修改会破坏导航栈的初始化状态，引发崩溃。

1. 正确获取NavHostFragment的NavController #

通过childFragmentManager找到布局中的nav_host_fragment实例，再获取其对应的导航控制器：

val navHostFragment = childFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController

2. 自动关联侧边栏与导航控制器 #

使用NavigationUI.setupWithNavController方法，让系统自动处理侧边栏菜单项的点击跳转，无需手动实现OnNavigationItemSelectedListener：

• 确保侧边菜单项的android:id与导航目标Fragment的ID完全一致
• 该方法会自动同步菜单项选中状态、处理跳转逻辑

3. 正确重置导航栈（替代修改startDestination） #

如果需要跳转到目标并清空之前的导航栈，使用NavOptions实现：

val options = NavOptions.Builder()
    .setPopUpTo(R.id.central_app_navigation, true) // 清空到根导航图
    .build()
navController.navigate(R.id.homeFragment, null, options)

1. 修改CentralNavigationFragment代码 #

@AndroidEntryPoint
class CentralNavigationFragment : Fragment() {

    val TAG: String = "CentralNavigationFragment"
    lateinit var binding: FragmentCentralNavigationBinding
    private lateinit var drawerToggle: ActionBarDrawerToggle

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        val toolbar: androidx.appcompat.widget.Toolbar = binding.toolbar
        val drawerLayout = binding.drawerLayout
        val navigationView = binding.navigationDrawer

        // 配置Toolbar
        (requireActivity() as AppCompatActivity).setSupportActionBar(toolbar)

        // 配置DrawerToggle
        drawerToggle = ActionBarDrawerToggle(
            requireActivity(),
            drawerLayout,
            toolbar,
            R.string.drawer_open,
            R.string.drawer_close
        )
        drawerLayout.addDrawerListener(drawerToggle)
        drawerToggle.syncState()

        // 正确获取NavHostFragment的导航控制器
        val navHostFragment = childFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        val navController = navHostFragment.navController

        // 自动关联侧边栏与导航控制器
        NavigationUI.setupWithNavController(navigationView, navController)

        // 初始化选中当前导航目标
        navigationView.setCheckedItem(navController.currentDestination?.id ?: R.id.homeFragment)
    }

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        binding = FragmentCentralNavigationBinding.inflate(inflater, container, false)
        return binding.root
    }

    override fun onDestroyView() {
        super.onDestroyView()
        binding.drawerLayout.removeDrawerListener(drawerToggle)
    }
}

2. 修改drawer_menu.xml（统一菜单项与导航目标ID） #

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:showIn = "navigation_view">
    <group android:checkableBehavior="single">
        <!-- 与homeFragment的ID一致 -->
        <item
            android:id="@+id/homeFragment"
            android:icon="@drawable/baseline_home_24"
            android:title="@string/home_fragment" />

        <!-- 与executedSOFragment的ID一致 -->
        <item
            android:id="@+id/executedSOFragment"
            android:icon="@drawable/baseline_menu_24"
            android:title="Stats metric" />
    </group>

    <item
        android:id="@+id/log_out"
        android:icon="@drawable/baseline_logout_24"
        android:title="Log out" />
</menu>

3. 处理登出等特殊操作（可选） #

如果需要处理登出这类不属于常规导航的操作，可保留点击监听并单独处理：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    // ...其他代码

    navigationView.setNavigationItemSelectedListener { item ->
        when(item.itemId) {
            R.id.log_out -> {
                // 执行登出逻辑，比如跳转到登录页
                navController.navigate(R.id.logOutFragment)
                drawerLayout.closeDrawer(GravityCompat.START)
                true
            }
            else -> {
                // 常规项交给NavigationUI处理
                NavigationUI.onNavDestinationSelected(item, navController)
                drawerLayout.closeDrawer(GravityCompat.START)
                true
            }
        }
    }
}

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