Jetpack Compose嵌套导航图切换报错：无法找到WELCOME路由目标

错误原因 #

直接跳转WELCOME路由失败，是因为WELCOME属于authNavGraph嵌套导航图，而你当前使用的根导航控制器对应根导航图（Graph.ROOT），根图中并未直接注册WELCOME这个目的地，导致导航系统无法找到它。

正确实现步骤 #

1. 确保嵌套导航图的规范定义 #

首先检查你的authNavGraph实现，必须通过navigation块定义完整的嵌套图结构，包含自身路由和内部目的地：

fun NavGraphBuilder.authNavGraph(navController: NavHostController, onBoardingPrefKeys: Boolean) {
    // 定义嵌套导航图的唯一路由和起始页
    navigation(
        route = Graph.AUTHENTICATION,
        startDestination = if (onBoardingPrefKeys) Graph.LOGIN else Graph.WELCOME
    ) {
        // 嵌套图内部的页面目的地
        composable(route = Graph.WELCOME) {
            WelcomeScreen(navController = navController)
        }
        composable(route = Graph.LOGIN) {
            LoginScreen(navController = navController)
        }
        // 其他认证相关页面
    }
}

同时确保路由常量定义清晰：

object Graph {
    const val ROOT = "root_graph"
    const val AUTHENTICATION = "auth_graph"
    const val HOME = "home_graph"
    const val WELCOME = "welcome"
    const val LOGIN = "login"
}

2. 两种正确跳转方式 #

方式一：使用完整路由路径跳转

如果需要从根导航图的其他页面（比如HOME）直接跳转到WELCOME，必须指定嵌套图路由 + 目的地路由的完整路径：

navController.navigate("${Graph.AUTHENTICATION}/${Graph.WELCOME}")

方式二：跳转嵌套图自动进入目标页

如果只是想进入认证流程并自动打开WELCOME，直接跳转嵌套图的路由即可，嵌套图会根据自身startDestination自动导航到对应页面：

navController.navigate(Graph.AUTHENTICATION)

这种方式更符合嵌套导航的设计逻辑，嵌套图会自行管理内部页面栈。

3. 避坑提醒 #

绝对不要直接使用navController.navigate(Graph.WELCOME)，根导航图中不存在该目的地，必须通过嵌套图的路由关联访问。

内容的提问来源于stack exchange，提问作者Mohammad Hanif Shaikh