Jetpack Compose中底部导航与跨屏导航协同问题排查

核心原因 #

崩溃本质是当前使用的导航图未注册MoreScreen目标页面——底部导航的Graph仅包含Home、Favorites、Listened、About四个页面，而HomePage内的跳转操作是在该Graph上下文执行的，找不到对应目标就会抛出异常。

具体解决步骤 #

1. 完善导航图结构，注册MoreScreen #

打开BottomNavigationGraph.kt，根据MoreScreen的页面层级，选择两种方式添加目标：

方式一：将MoreScreen设为Home的子页面（嵌套子图）

// BottomNavigationGraph.kt
fun bottomNavGraph(navController: NavHostController) = navigation(
    startDestination = Screen.Home.route
) {
    // 把Home页面改为嵌套子图，包含Home和MoreScreen
    navigation(startDestination = Screen.Home.route, route = Screen.Home.route) {
        composable(Screen.Home.route) {
            HomePage(navController = navController)
        }
        composable(Screen.More.route) {
            MoreScreen()
        }
    }
    composable(Screen.Favorites.route) {
        FavoritesPage()
    }
    composable(Screen.Listened.route) {
        ListenedPage()
    }
    composable(Screen.About.route) {
        AboutPage()
    }
}

方式二：将MoreScreen设为全局独立页面（根导航图注册）

如果MoreScreen不属于Home的子页面，直接在根NavHost中注册：

// Navigation.kt
@Composable
fun SetupNavGraph(navController: NavHostController = rememberNavController()) {
    NavHost(navController = navController, startDestination = Screen.Home.route) {
        bottomNavGraph(navController = navController)
        // 直接在根导航图添加MoreScreen
        composable(Screen.More.route) {
            MoreScreen()
        }
    }
}

2. 校验跳转逻辑与路由定义 #

• 检查HomePage的跳转代码，确保使用正确的路由：

// HomePage.kt 跳转代码
navController.navigate(Screen.More.route)

• 确认Screen.kt中More的路由字符串无拼写错误：

// Screen.kt
sealed class Screen(val route: String) {
    object Home : Screen("home")
    object Favorites : Screen("favorites")
    object Listened : Screen("listened")
    object About : Screen("about")
    object More : Screen("more") // 确保路由字符串准确
}

3. 排查导航上下文与缓存问题 #

• 确保跳转使用的是正确的导航控制器：如果是全局页面，要传递根导航控制器，而非底部导航的子控制器。
• 清理项目缓存并重新构建（Build -> Clean Project → Build -> Rebuild Project），避免旧代码缓存干扰。

额外验证点 #

查看Logcat完整错误栈，确认是否是路由拼写错误、导航图嵌套层级混乱，或是MoreScreen带参数时的参数格式不匹配问题。

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