Android Navigation Component底部导航popBackStack后崩溃

API 探路者

2026-8-29

问题根因

底部菜单ID与导航节点不匹配：底部菜单第三个item id为action_bookmarks，但主导航图main_graph中仅配置了home_graph、search_graph、account_graph三个子节点，无对应id的导航目的地。NavigationUI执行选中逻辑时找不到匹配的NavDestination返回null，直接触发空指针异常。
popBackStack调用逻辑错误：重选回调中调用navController?.popBackStack(it.itemId, false)时，传入的目标id是子导航图本身的id，而非子图内的可展示页面id。当子图内部存在压栈页面时，该调用会将子图内所有页面弹出直到子图节点本身，但子图节点不是可直接渲染的实际目的地，导航组件会自动继续回退到主导航的默认起始页home_graph，这就是重选搜索、账户标签自动切回首页的直接原因。
导航状态错乱导致路由找不到：重选首页标签时，上述pop逻辑会将首页子图内部的根页面也弹出栈，导致当前导航停留在不可展示的子图节点上，此时调用定义在具体页面下的导航action时，无法在当前节点匹配到对应action配置，触发IllegalArgumentException崩溃。
内置逻辑被干扰：NavigationUI 2.4.0及以上版本已经内置了多返回栈场景下的重选弹根逻辑，手动设置的错误重选监听打乱了内置的返回栈状态管理，进一步加剧了异常。

正确实现方案

对齐菜单与导航节点ID
修改底部菜单或主导航图配置，保证所有底部菜单项的id，与主导航图的直接子节点（include的子导航图、顶层destination）id完全一一对应。针对当前代码，要么在main_graph中添加id为action_bookmarks的对应导航节点，要么将菜单中action_bookmarks项的id修改为已存在的对应子图id，这是NavigationUI多返回栈正常工作的基础前提。

替换错误的重选弹栈逻辑
如果你使用的是androidx.navigation:navigation-ui:2.4.0及以上稳定版本，直接删除手动设置setOnItemReselectedListener的代码即可。NavigationUI.setupWithNavController方法已经内置了重选标签时自动将对应返回栈弹回根目的地的逻辑，完全适配多返回栈机制，不会出现返回栈错乱问题。
如果你需要在重选标签时增加自定义逻辑（比如控制页面列表回滚到顶部、埋点上报），自定义重选监听时请使用和NavigationUI内部逻辑一致的弹栈写法，不要直接调用简单的双参数popBackStack：

private fun setNavigation() {
    binding.bottomNavBar.itemIconTintList = null
    binding.bottomNavBar.setOnItemReselectedListener { menuItem ->
        // 此处可添加自定义逻辑，比如首页列表回滚到顶部、重选埋点上报等
        val controller = navController ?: return@setOnItemReselectedListener
        // 正确弹栈：仅弹出子图内部压栈页面，保留子图在主导航栈的位置，最终回到子图根目的地
        val navOptions = NavOptions.Builder()
            .setPopUpTo(menuItem.itemId, inclusive = false, saveState = false)
            .setLaunchSingleTop(true)
            .build()
        controller.navigate(menuItem.itemId, null, navOptions)
    }
    navController?.let { NavigationUI.setupWithNavController(binding.bottomNavBar, it) }
}

基础配置校验
确认每个子导航图都配置了正确的app:startDestination，主导航图的起始目的地id与底部导航默认选中项id保持一致，避免初始加载时的状态错乱。

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