Jetpack Compose带参数导航报错：无法找到匹配的导航目标

核心问题：路由参数占位符定义错误 #

你的报错根源是**SecondNavigationDestination中带参数的路由格式错误**——没有用大括号{}包裹参数名，导致Navigation无法识别这是一个参数占位符，反而将其视为固定的路径片段。

当前错误的路由定义：

val routeWithArg = "${route}/$nameArg" // 最终生成 "second_screen/nameArg"

这个定义意味着Navigation只会匹配路径完全等于second_screen/nameArg的目的地，而你实际导航的是second_screen/Item Six，自然找不到匹配目标。

修复步骤 #

1. 修正带参数的路由定义 #

将routeWithArg改为用大括号包裹参数名，让Navigation识别这是参数占位符：

object SecondNavigationDestination: NavigationDestination{
    override val route = "second_screen"
    const val nameArg = "nameArg"
    // 修正：用大括号包裹参数名，定义参数占位符
    val routeWithArg = "${route}/{${nameArg}}"
}

2. 处理含特殊字符的参数（可选但推荐） #

如果参数值包含空格、斜杠等特殊字符，直接拼接字符串可能导致路由解析异常，建议对参数进行URL编码：

// 在HomeScreen的导航代码中修改
navController.navigate("${SecondNavigationDestination.route}/${Uri.encode(nameString)}") {
    launchSingleTop = true
}

3. 验证参数获取逻辑（可选） #

你的MainViewModel通过SavedStateHandle获取参数的逻辑是正确的，修复路由定义后即可正常拿到参数值。如果需要在SecondScreen的Composable中直接获取参数，也可以通过backStackEntry获取：

@Composable
fun SecondScreen(
){
    val backStackEntry = rememberBackStackEntry()
    val name = backStackEntry.arguments?.getString(SecondNavigationDestination.nameArg) ?: "empty"
    val viewModel: MainViewModel = viewModel()
    Box(
        contentAlignment = Alignment.Center
    ){
        Text(text = name)
    }
}

验证修复 #

完成以上修改后，点击包含空格的Item（比如"Item Six"），Navigation就能正确匹配到second_screen/{nameArg}的目的地，参数也能正常传递和获取。

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