配置变更时Jetpack Compose导航异常及ViewModel数据留存问题求助

配置变更时，Compose Navigation 默认会重建 NavHost，导致导航栈被重置回 startDestination；同时页面级 ViewModel 会因原页面从导航栈中移除而被销毁，自然无法留存数据。而单个页面场景下，ViewModel 绑定到 Activity/Fragment 生命周期，配置变更时能被系统自动保留。

1. 给ViewModel绑定正确的导航作用域 #

别在页面 Composable 里直接用 viewModel() 创建实例，要绑定到导航条目（BackStackEntry）的生命周期，确保配置变更后导航栈恢复时，ViewModel 能复用：

• 用 Hilt 的话，直接用 hiltViewModel()，它会自动绑定当前导航条目：

  @Composable
  fun UserDetailScreen(navController: NavHostController) {
      val viewModel: UserDetailViewModel = hiltViewModel()
      // 页面逻辑
  }
  

• 不用 Hilt 的话，手动指定存储所有者为当前导航条目：

  @Composable
  fun UserDetailScreen(navController: NavHostController) {
      val backStackEntry = remember(navController) {
          navController.getBackStackEntry("user_detail_route")
      }
      val viewModel: UserDetailViewModel = viewModel(storeOwner = backStackEntry)
      // 页面逻辑
  }
  

2. 保留NavController的状态 #

确保 NavController 在配置变更时不丢失导航栈状态，用 rememberSaveable 加 NavController.saver 来持久化：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            AppTheme {
                val coroutineScope = rememberCoroutineScope()
                val navController = rememberSaveable(
                    key = "nav_controller",
                    saver = NavController.saver(coroutineScope)
                ) {
                    NavController(this)
                }
                NavHost(
                    navController = navController,
                    startDestination = "home"
                ) {
                    // 定义你的导航目的地
                }
            }
        }
    }
}

注：rememberNavController() 内部已经做了状态保留，但如果你的 NavHost 被嵌套在会频繁重建的 Composable 里，还是建议手动用上面的方式确保状态安全。

3. 避免NavHost被不必要重建 #

检查 NavHost 的父级 Composable，别让它依赖会随配置变更变化的状态（比如屏幕方向相关的变量），否则会触发 NavHost 重建，导致导航栈重置。

4. 排查导航图配置 #

确认导航图的 startDestination 是固定值，没有在运行时被动态修改；同时确保所有目的地的路由定义正确，避免重建时导航到错误页面。

配置变更后，通过以下方式确认修复效果：

• 打印 navController.backStack，检查导航栈是否保留了之前的页面
• 在 ViewModel 的 onCleared() 方法加日志，确认配置变更时没有被调用

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