Jetpack Navigation：如何检查路由是否存在以避免IllegalArgumentException崩溃

问题背景 #

动态构建Navigation导航图时，调用navController.navigate(route)经常因为目标路由还没加载完成（竞态条件）抛出崩溃异常：

java.lang.IllegalArgumentException: Navigation destination that matches request NavDeepLinkRequest{ uri=android-app://androidx.navigation/XXX } cannot be found in the navigation graph NavGraph(0x0) startDestination={Destination(0x78d845ec) route=home}

目前找不到官方提供的navController.exists(route)这类前置检查方法，之前有人建议检查navController.currentBackStackEntry?.destination?.id，但这只针对当前路由，和目标路由无关。

可行解决方法 #

1. 递归遍历导航图检查路由 #

自己封装一个扩展方法，递归遍历整个导航图的所有节点，判断目标路由是否存在：

fun NavController.routeExists(route: String): Boolean {
    fun checkDestination(graph: NavGraph): Boolean {
        for (dest in graph) {
            if (dest.route == route) return true
            if (dest is NavGraph && checkDestination(dest)) return true
        }
        return false
    }
    return checkDestination(graph)
}

使用时直接在navigate()前判断：

Column(modifier = Modifier
       .fillMaxSize()   
       .align(Alignment.CenterStart)
       .clickable {     
           if (navController.routeExists(item.key)) {
               navController.navigate(item.key) 
           }
       }) { ...  }  

注意：如果导航图是异步加载的，要保证检查和导航操作在同一线程执行，避免检查完路由才被加载/移除的竞态问题，比如用lifecycleScope包裹操作。

2. 利用DeepLink匹配机制验证 #

Navigation内部是通过DeepLink请求匹配路由的，我们可以复用这个逻辑来做检查，这种方式还能支持带参数的路由：

fun NavController.isRouteValid(route: String): Boolean {
    val deepLinkRequest = NavDeepLinkRequest.Builder
        .fromUri(NavDestination.createRoute(route).toUri())
        .build()
    return graph.matchDeepLink(deepLinkRequest) != null
}

3. 异常捕获作为最后兜底 #

如果前面的检查还是因为极端竞态条件失效（比如检查后路由被立刻移除），可以配合异常捕获做最后一层防护，避免崩溃：

clickable {     
    runCatching {
        navController.navigate(item.key)
    }.onFailure { e ->
        if (e is IllegalArgumentException) {
            // 这里做优雅处理，比如提示用户"页面正在加载中"或者记录日志
        }
    }
}

注意事项 #

尽量优先使用前两种前置检查方案，异常捕获只作为兜底——毕竟异常处理有额外性能开销，而且属于事后补救，不符合代码设计的预防原则。

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