Android Jetpack Compose嵌套导航返回栈行为优化及状态恢复问题

问题场景 #

我在Compose应用中配置了多个独立页面和一个嵌套导航图，导航代码如下：

composable(
    route = RackInspectionScreen.RackInspectionObservationsRecommendationsScreen.route
){
    RackInspectionObservationsRecommendationsScreen(navController = navController)
}

// 嵌套导航图
navigation(
    startDestination = RackInspectionScreen.RackInspectionDamageReportAreaScreen.route,
    route = "rack_inspection_damage_report_route"
) {
    composable(
        route = RackInspectionScreen.RackInspectionDamageReportAreaScreen.route
    ){
        RackInspectionDamageReportAreaScreen(navController = navController)
    }

    composable(
        route = RackInspectionScreen.RackInspectionDamageReportRunScreen.route
    ){
        RackInspectionDamageReportRunScreen(navController = navController)
    }
    // 更多子页面...
}

composable(
    route = RackInspectionScreen.RackInspectionAppendix1RackInspectionProceduresScreen.route
){
    RackInspectionAppendix1RackInspectionProceduresScreen(navController = navController)
}

composable(
    route = RackInspectionScreen.RackInspectionAppendix2DamageAssessmentGuidelinesScreen.route
){
    RackInspectionAppendix2DamageAssessmentGuidelinesScreen(navController = navController)
}
// 更多独立页面...

通过NavigationDrawer实现页面切换，点击导航项的逻辑如下：

navigationItems.forEachIndexed { index, navigationItem ->
    NavigationDrawerItem(
        modifier = modifier
            .padding(NavigationDrawerItemDefaults.ItemPadding),
        label = { Text(text = navigationItem.title) },
        selected = index == selectedItemIndex,
        onClick = {
            selectedItemIndex = index
            scope.launch {
                drawerState.close()
            }
            Log.d(TAG, navigationItem.route)
            navHostController.navigate(route = navigationItem.route ){
                // 之前的配置无效：
                // popUpTo(navigationItem.route){ 
                //     inclusive = true
                // }
            }
        }
    )
}

需求是：切换页面时减少返回栈中的重复实例，每个独立页面和嵌套导航栈仅保留一个；且切换回嵌套导航时，能回到之前停留的子页面位置。

解决方案 #

利用Navigation组件的多返回栈特性，配合popUpTo、launchSingleTop和restoreState参数实现需求，具体步骤如下：

1. 修正导航项的Route配置 #

确保嵌套导航的入口项对应的是嵌套导航图的根Route（即rack_inspection_damage_report_route），而不是其中的子页面Route。这样Navigation才能正确识别并管理整个嵌套导航栈的状态。

2. 优化Navigate参数配置 #

修改导航抽屉点击事件中的navigate逻辑，添加三个关键参数：

navHostController.navigate(navigationItem.route) {
    // 弹出到导航图的根节点，同时保存各个导航栈的状态
    popUpTo(navHostController.graph.startDestinationId) {
        saveState = true
    }
    // 确保目标页面/导航栈仅存在一个实例
    launchSingleTop = true
    // 恢复之前保存的导航栈状态（针对嵌套导航，回到之前停留的子页面）
    restoreState = true
}

参数说明 #

• popUpTo(navHostController.graph.startDestinationId)：将返回栈弹出到应用导航图的根，配合saveState = true可以保存每个独立页面/嵌套导航栈的状态，避免重复实例堆积。
• launchSingleTop = true：确保目标页面/导航栈不会被重复添加到返回栈中，始终只保留一个实例。
• restoreState = true：切换回嵌套导航图时，自动恢复之前停留的子页面状态，无需重新从启动页进入。

为什么之前的配置无效？ #

之前直接popUpTo(navigationItem.route)的问题在于：

• 如果导航项是嵌套导航的子页面，该配置只会弹出该子页面之上的栈，无法处理整个应用返回栈的重复问题。
• 没有利用Navigation的多返回栈状态保存机制，导致切换回嵌套导航时无法恢复之前的位置。

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