Jetpack Compose底部栏嵌套导航状态保留与返回异常问题

问题根因 #

这不是框架Bug，是两处实现逻辑不符合Navigation组件的状态保存规则：

1. 初始实现缺少已选中Tab的点击拦截逻辑，重复触发navigate时会被launchSingleTop规则拦截丢弃，表现为点击Tab无响应
2. 修改参数时将restoreState设为false，切换Tab时无法恢复之前保存的嵌套页状态，反而会重复创建对应导航图的起始页条目压入返回栈，导致按返回键时跳转到错误页面

正确实现方案 #

1. 补全Tab点击前置判断 #

点击底部Tab时先判断当前是否已经处于目标Tab的导航图内：

• 如果已选中：直接回退到当前Tab嵌套导航图的起始页，实现点击已选Tab回到顶层页的交互，不重复执行导航操作
• 如果未选中：再执行带状态保存/恢复的跳转逻辑

2. 保留官方推荐的导航参数配置 #

不要修改restoreState = true的配置，该参数负责切换Tab时恢复对应导航图之前保存的返回栈状态，是保留嵌套页面状态的核心配置。
完整的BottomNavigationItem点击逻辑代码如下：

BottomNavigationItem(
    onClick = {
        val currentSelected = currentDestination?.hierarchy?.any { it.route == screen.route } == true
        if (currentSelected) {
            // 已选中当前Tab，回退到该Tab导航图的起始页
            navController.popBackStack(
                route = screen.route,
                inclusive = false
            )
            return@BottomNavigationItem
        }
        navController.navigate(screen.route) {
            popUpTo(navController.graph.findStartDestination().id) {
                saveState = true
            }
            launchSingleTop = true
            restoreState = true // 必须保持为true，用于恢复已保存的Tab返回栈
        }
    },
    selected = currentDestination?.hierarchy?.any { it.route == screen.route } == true,
    icon = { Icon(imageVector = screen.icon, contentDescription = null) },
    label = { Text(stringResource(screen.label)) }
)

3. 前置配置检查 #

确保导航图结构符合要求：

• 每个底部Tab对应一个独立的嵌套NavGraph，嵌套图的route和你定义在items列表里的screen.route完全一致
• 每个嵌套NavGraph指定自己的startDestination为对应Tab的首页（比如Graph1的startDestination是Screen1）
• 不要直接将Tab的一级/二级页面作为根导航图的直接目的地，否则无法实现每个Tab独立的返回栈保存

效果说明 #

配置完成后可以实现预期交互：

• 从Graph1的Screen2切换到Graph2的任意页面后，点击Graph1的Tab可以直接回到之前停留的Screen2，状态完全保留
• 按系统返回键时，会先从当前Tab的二级页面退回到当前Tab的首页，再次按返回才会退出应用，不会跳转到其他Tab的页面，也不会产生多余的返回栈条目

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