Android Compose导航异常：无法在导航图中找到匹配NavDeepLinkRequest的导航目标

这个问题我之前也踩过坑，核心原因是你直接把Uri字符串拼接到导航路径里时，Uri中的特殊字符（比如/、:）会被导航系统当成路由的分隔符，而不是参数的一部分，导致无法匹配你定义的document/{documentUri}路由。下面给你几个可行的解决方案：

方案一：编码Uri字符串作为路径参数 #

先对Uri的完整字符串进行URL编码，确保特殊字符被转义，这样导航系统会把整个编码后的字符串当成一个独立参数：

导航时的代码修改： #

onDocumentClicked = { uri ->
    val encodedUri = Uri.encode(uri.toString())
    navController.navigate("document/$encodedUri")
}

目的地接收参数的修改： #

改用StringType并解码还原Uri：

composable(
    "document/{documentUri}",
    arguments = listOf(navArgument("documentUri") { type = NavType.StringType })
) { navBackStackEntry ->
    navBackStackEntry.arguments?.getString("documentUri")?.let { encodedUri ->
        val documentUri = Uri.parse(Uri.decode(encodedUri))
        PdfDocumentView(uri = documentUri)
    }
}

方案二：改用查询参数传递Uri（更简洁） #

把参数从路径参数改成查询参数，彻底避免特殊字符干扰路由匹配：

修改NavHost中的目的地定义： #

composable(
    "document",
    arguments = listOf(navArgument("documentUri") {
        type = NavType.ParcelableType(Uri::class.java)
        nullable = true
    })
) { navBackStackEntry ->
    navBackStackEntry.arguments?.getParcelable<Uri>("documentUri")?.let { documentUri ->
        PdfDocumentView(uri = documentUri)
    }
}

导航时的代码： #

onDocumentClicked = { uri ->
    navController.navigate(
        route = "document",
        args = bundleOf("documentUri" to uri)
    )
}

方案三：使用Safe Args（推荐，类型安全） #

Jetpack Navigation的Safe Args插件可以自动处理参数的传递和解析，完全避免手动编码的麻烦，还能保证类型安全：

1. 首先在Module级build.gradle中添加插件：

plugins {
    // 其他插件...
    id "androidx.navigation.safeargs.kotlin"
}

2. 导航时直接使用自动生成的方向类：

// 假设生成的方向类是DocumentListDirections
onDocumentClicked = { uri ->
    val action = DocumentListDirections.actionDocumentListToDocument(uri)
    navController.navigate(action)
}

3. 目的地接收参数时，Safe Args会自动生成类型安全的解析方法，无需手动处理Bundle。

为什么之前的尝试没生效？ #

你之前尝试编码但没解决问题，大概率是因为编码不彻底，或者解码时没正确还原Uri。比如直接用uri.toString()拼路径，里面的/会被导航系统拆分成多个路由段，导致匹配不到document/{documentUri}这个单一参数的路由。

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