Android Jetpack Compose点击登录按钮跳转报错：无法导航至NavDeepLinkRequest

核心问题分析 #

报错提示Navigation graph has not been set for NavController，本质是点击登录按钮时使用的NavHostController实例未与应用导航图（NavHost）绑定，或目标路由未正确注册到导航图中。

具体修复方案 #

1. 确保登录组件使用正确的NavController实例 #

检查LoginSection中调用导航的navController是否是从LocalNavController获取的全局实例，而非重新创建。建议通过回调传递导航逻辑，避免在子组件中错误创建控制器：

@Composable
fun LoginSection(onLoginClick: () -> Unit) {
    Button(onClick = onLoginClick) {
        Text("Log in")
    }
}

@Composable
fun LoginScreen() {
    val navController = LocalNavController.current
    LoginSection(
        onLoginClick = {
            // 使用路由字符串直接跳转，而非未配置的DeepLink
            navController.navigate("lessons")
        }
    )
}

2. 验证导航图中目标路由的注册 #

检查Navigation函数内的NavHost，确认lessons等路由已正确添加到导航图：

@Composable
fun Navigation(navController: NavHostController) {
    NavHost(
        navController = navController,
        startDestination = "login" // 可根据登录状态动态切换起始页
    ) {
        composable("login") { LoginScreen() }
        composable("lessons") { LessonsScreen() }
        composable("practice") { PracticeScreen() }
        composable("profile") { ProfileScreen() }
    }
}

3. 确认MainScreen中NavController的传递逻辑 #

确保MainScreen中创建的NavController正确传递给NavHost，且整个应用共用同一个实例：

@Composable
fun MainScreen() {
    val navController = rememberNavController()
    
    Scaffold(
        topBar = { /* 顶部栏显示逻辑 */ },
        bottomBar = { BottomNavigationBar(navController = navController) }
    ) { innerPadding ->
        Box(modifier = Modifier.padding(innerPadding)) {
            Navigation(navController = navController)
        }
    }
}

4. 排查DeepLink配置（若使用） #

如果代码中确实需要通过DeepLink跳转lessons，需在导航图中添加对应配置：

composable(
    route = "lessons",
    deepLinks = listOf(
        navDeepLink {
            uriPattern = "android-app://androidx.navigation/lessons"
        }
    )
) { LessonsScreen() }

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