Compose Navigation传递可选参数时导航目标找不到报错排查

你遇到的导航错误本质是路由定义、Composable配置、导航调用三者完全不匹配：

• 你原定的路由是路径参数格式task_detail_screen/{id}/{menuActionType}，但实际注册Composable时用了查询参数格式task_detail_screen?id={id}，还漏掉了必选的menuActionType参数
• 导航时用了路径参数形式task_detail_screen/${AgendaMenuActionType.OPEN.name}，但导航图里根本没有匹配这个格式的目标路由

按照「menuActionType必选（路径参数）、id可选（查询参数）」的需求，重新统一路由配置和导航逻辑：

1. 修正Composable路由注册 #

composable(
    route = "task_detail_screen/{menuActionType}?id={id}",
    arguments = listOf(
        // 必选参数：menuActionType，字符串类型
        navArgument("menuActionType") {
            type = NavType.StringType
            nullable = false
        },
        // 可选参数：id，Int类型，默认值设为null或0（根据业务需求调整）
        navArgument("id") {
            type = NavType.IntType
            nullable = true
            defaultValue = null
        }
    )
) { backStackEntry ->
    // 解析参数
    val menuActionType = backStackEntry.arguments?.getString("menuActionType")?.let {
        AgendaMenuActionType.valueOf(it)
    } ?: AgendaMenuActionType.OPEN // 兜底处理，避免空值
    val taskId = backStackEntry.arguments?.getInt("id")

    TaskDetailScreen(
        menuActionType = menuActionType,
        taskId = taskId,
        navHostController = navHostController
    )
}

2. 修正导航调用逻辑 #

根据是否需要传递id，构造对应的路由字符串：

• 不需要传id时：

navHostController.navigate("task_detail_screen/${AgendaMenuActionType.OPEN.name}")

• 需要传id时：

val taskId = 123 // 实际业务中的任务ID
navHostController.navigate("task_detail_screen/${AgendaMenuActionType.EDIT.name}?id=$taskId")

3. 关键注意点 #

• 必选参数必须放在路径部分（用{参数名}），可选参数放在查询参数部分（用?参数名={参数名}）
• 导航时的路由格式必须和Composable注册的路由完全匹配，参数位置、类型不能错
• 解析枚举类型参数时，要做好兜底处理，避免参数非法导致崩溃

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