Android应用Fragment未加入导航栈，返回键直接退出问题求助

问题根源 #

默认的NavigationUI.setupWithNavController在切换底部导航项时，会将目标Fragment设置为根目的地，清除之前的回退栈，导致点击返回键直接退出应用，无法保留startFragment与register/loginFragment、landingFragment与rankingFragment之间的导航层级。

解决方案 #

1. 替换默认底部导航绑定逻辑，手动处理导航 #

放弃使用NavigationUI.setupWithNavController，自定义底部导航项的选中事件，确保切换时保留回退栈：

binding.mainNavMenu.setOnItemSelectedListener { item ->
    when (item.itemId) {
        R.id.startFragment -> {
            if (navController.currentDestination?.id != R.id.startFragment) {
                navController.navigate(
                    R.id.startFragment,
                    null,
                    NavOptions.Builder()
                        // 不弹出startFragment，保留其在栈中的位置
                        .setPopUpTo(R.id.startFragment, false)
                        .build()
                )
            }
            true
        }
        R.id.landingFragment -> {
            if (navController.currentDestination?.id != R.id.landingFragment) {
                navController.navigate(
                    R.id.landingFragment,
                    null,
                    NavOptions.Builder()
                        .setPopUpTo(R.id.landingFragment, false)
                        .build()
                )
            }
            true
        }
        // 其他底部导航项按同样逻辑处理
        else -> false
    }
}

2. 自定义系统返回键逻辑 #

重写返回键处理，判断当前页面和回退栈状态，决定是回退到上一个Fragment还是退出应用：

方式1：重写onBackPressed（适用于旧版AndroidX）

override fun onBackPressed() {
    val currentDestId = navController.currentDestination?.id
    val hasBackStack = navController.backQueue.size > 1

    // 如果当前是底部导航的根Fragment且栈内有其他页面，回退；否则退出
    if ((currentDestId == R.id.startFragment || currentDestId == R.id.landingFragment) && hasBackStack) {
        navController.popBackStack()
    } else {
        super.onBackPressed()
    }
}

方式2：使用OnBackPressedCallback（推荐，AndroidX 1.0.0+）

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ... 其他初始化代码

    val backCallback = object : OnBackPressedCallback(true) {
        override fun handleOnBackPressed() {
            val currentDestId = navController.currentDestination?.id
            val hasBackStack = navController.backQueue.size > 1

            if ((currentDestId == R.id.startFragment || currentDestId == R.id.landingFragment) && hasBackStack) {
                navController.popBackStack()
            } else {
                finish()
            }
        }
    }
    onBackPressedDispatcher.addCallback(this, backCallback)
}

3. 确保Fragment间跳转保留回退栈 #

在startFragment跳转到register/loginFragment、landingFragment跳转到rankingFragment时，使用标准的navigate方法，且不要在导航action中设置清除栈的属性：

// startFragment中跳转至registerFragment
findNavController().navigate(R.id.action_startFragment_to_registerFragment)

// landingFragment中跳转至rankingFragment
findNavController().navigate(R.id.action_landingFragment_to_rankingFragment)

同时检查导航图（nav_graph.xml）中的对应action，确保没有设置：

<!-- 禁止此类设置，否则会清除回退栈 -->
app:popUpTo="@id/startFragment"
app:popUpToInclusive="true"

关键注意事项 #

• 保持所有Fragment都通过同一个NavHostFragment管理，不要手动使用FragmentManager进行replace操作
• 底部导航的每个项对应的Fragment需在导航图中注册为独立目的地
• 测试时注意观察navController.backQueue的变化，确保栈结构符合预期

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