Android Compose嵌套NavHostController首次状态恢复失败问题排查

1. App导航栈未保存MAIN页面状态：从MAIN跳转到SECOND时，App级NavHost默认不会保存MAIN页面的状态，导致MainView及其内部的子NavController被销毁，返回时重新创建，丢失之前的滚动状态。
2. MainCoordinator与NavController生命周期不匹配：MainCoordinator在MainActivity中创建，而子NavController在MainView中通过rememberNavController()初始化，当MainView被销毁后，旧的NavController失效，新创建的NavController无法获取之前保存的底部导航状态。

1. 为App导航栈的MAIN页面启用状态保存 #

修改MainActivity中的NavHost配置，为"MAIN"页面添加saveState = true，确保跳转到SECOND时MAIN页面的状态被保留：

// MainActivity
NavHost(
    navController = appCoordinator.getController(),
    startDestination = "MAIN",
) {
    composable("MAIN", saveState = true) {
        MainView(appCoordinator, mainCoordinator)
    }
    composable("SECOND"){
        SecondView(appCoordinator)
    }
}

2. 让MainCoordinator与子NavController生命周期绑定 #

将MainCoordinator的创建移到MainView内部，使用remember确保它与MainView的Composition生命周期一致，避免NavController被重复创建：

// MainView 修改后
val mainCoordinator = remember { 
    MainCoordinator(rememberNavController()) 
}
Scaffold(
    bottomBar = { BottomNavigation(mainCoordinator) }
) { padding ->
    NavHost(
        modifier = Modifier.padding(padding),
        navController = mainCoordinator.getNavController(),
        startDestination = mainCoordinator.getStartDestination().route,
        saveState = true
    ) {
        composable("MAIN-FEED", saveState = true) { FeedView() }
        composable("MAIN-TEST") { TestView(appCoordinator) }
    }
}

3. 确认底部导航状态恢复逻辑 #

保持MainCoordinator中的底部导航逻辑不变，确认restoreState = true和saveState = true已正确设置：

// Main Coordinator 底部导航逻辑
navController.navigate(bottomNavScreen.route) {
    launchSingleTop = true
    restoreState = true
    popUpTo(findStartDestination(navController.graph).id) {
        saveState = true
    }
}

4. 可选：为FeedView滚动状态手动保存 #

如果上述修改后仍有问题，可使用rememberSaveable为滚动组件显式保存状态：

// FeedView 修改示例
val columnScrollState = rememberSaveable(stateSaver = LazyListState.Saver) {
    LazyListState()
}
val rowScrollState1 = rememberSaveable(stateSaver = LazyListState.Saver) {
    LazyListState()
}

Column(
    modifier = Modifier.verticalScroll(columnScrollState)
) {
    LazyRow(state = rowScrollState1) {
        // 列表内容
    }
    // 其他LazyRow组件
}

• 启用saveState = true后，App导航栈会保存MAIN页面的完整状态，包括子NavController的状态，返回时不会重新创建全新实例。
• 将MainCoordinator绑定到MainView的生命周期，避免NavController被重复替换，保证状态的连续性。
• 手动保存滚动状态可进一步确保复杂滚动组件的状态不丢失，适配极端场景。

内容的提问来源于stack exchange，提问作者Carlo-Rodriguez