Compose导航传clientId报错：无法找到匹配的导航目标

1. 路由定义与导航图配置不匹配 #

如果你的路由定义包含参数占位符（比如const val ClientDetailRoute = "client_detail/{clientId}"），但导航图中注册的Composable路由未包含该占位符，或者反过来，就会导致找不到匹配的导航目标。

错误配置示例：

// 路由定义
const val ClientDetailRoute = "client_detail/{clientId}"

// 导航图注册错误（缺失参数占位符）
navGraphBuilder.composable("client_detail") {
    ClientDetailScreen()
}

正确配置：

navGraphBuilder.composable(ClientDetailRoute) { backStackEntry ->
    val clientId = backStackEntry.arguments?.getString("clientId") ?: ""
    ClientDetailScreen(clientId = clientId)
}

2. 参数传递格式与路由规则不匹配 #

如果路由采用路径参数（/{clientId}），但跳转时误用了查询参数格式（?clientId=xxx），或者路径拼接错误，会导致路由不匹配。

错误跳转方式：

// 路由为client_detail/{clientId}，却用查询参数跳转
navController.navigate("client_detail?clientId=$clientId")

正确跳转方式：

navController.navigate("client_detail/$clientId")

若要使用查询参数，需修改路由定义并在导航图中声明参数规则：

composable(
    route = "client_detail?clientId={clientId}",
    arguments = listOf(
        navArgument("clientId") { type = NavType.StringType }
    )
) { backStackEntry ->
    val clientId = backStackEntry.arguments?.getString("clientId") ?: ""
    ClientDetailScreen(clientId)
}

3. 路由字符串拼写/大小写不一致 #

Jetpack Compose导航的路由是大小写敏感的。比如定义的路由是"ClientDetail"，但跳转时写了"clientDetail"，就会触发找不到目标的异常。请检查路由常量、导航图注册、跳转代码中的路由字符串是否完全一致。

4. 类型安全导航的参数类型不匹配 #

如果使用了类型安全导航插件（如Safe Args）或Hilt Navigation生成的导航函数，需确保传递的参数类型与定义一致。例如定义的clientId是Int类型，却传递了String：

错误示例：

// 生成的导航函数期望Int类型
navController.navigateToClientDetail(clientId = "123")

正确示例：

navController.navigateToClientDetail(clientId = 123)

5. 嵌套导航图的路由前缀缺失 #

如果目标页面在嵌套导航图中，跳转时需加上父路由的前缀。比如父路由为"main"，子路由为"client_detail/{clientId}"，跳转时需使用"main/client_detail/$clientId"，或者确保在正确的导航图范围内调用navigate。

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