如何手动清除ViewModel并丢弃SavedState（Navigation多栈场景）

Navigation 2.4.0的多返回栈机制会自动保存底部导航页面对应ViewModel的状态，但by navGraphViewModels()绑定的ViewModel不会在navGraph从返回栈移除后立即销毁——这类ViewModel会被NavController的ViewModelStore保留，直到整个NavController生命周期结束。要在登出等场景下手动清除这些ViewModel并丢弃SavedState，可以按以下方式实现：

方法一：直接清除指定navGraph的ViewModelStore #

每个navGraph都有独立的ViewModelStore，通过getViewModelStoreOwner()获取对应navGraph的ViewModelStoreOwner后，调用viewModelStore.clear()即可销毁该graph下的所有ViewModel，同时清理关联的SavedState：

// 替换为你的底部导航对应的所有navGraph ID
val bottomNavGraphIds = listOf(R.id.home_graph, R.id.dashboard_graph, R.id.profile_graph)

bottomNavGraphIds.forEach { graphId ->
    navController.getViewModelStoreOwner(graphId)?.viewModelStore?.clear()
}

方法二：结合返回栈重置+ViewModel清理 #

登出时通常需要跳转到登录页并清空所有历史返回栈，再配合ViewModelStore清理，确保彻底销毁旧状态：

// 1. 导航到登录页并清空所有返回栈（包含根导航图）
navController.navigate(R.id.login_dest) {
    popUpTo(navController.graph.id) {
        inclusive = true
    }
}

// 2. 清除底部导航关联navGraph的ViewModelStore
val bottomNavGraphIds = listOf(R.id.home_graph, R.id.dashboard_graph, R.id.profile_graph)
bottomNavGraphIds.forEach { graphId ->
    navController.getViewModelStoreOwner(graphId)?.viewModelStore?.clear()
}

方法三：自定义ViewModel清理逻辑（可选） #

如果需要更精细的控制（比如只清理部分数据而非销毁ViewModel），可以在ViewModel中定义清理方法，手动清除SavedStateHandle和内部数据：

class HomeViewModel(private val savedStateHandle: SavedStateHandle) : ViewModel() {
    // 自定义清理方法
    fun clearUserData() {
        // 清除SavedStateHandle中的所有键值对
        savedStateHandle.keys().forEach { key ->
            savedStateHandle.remove<Any>(key)
        }
        // 清理ViewModel内的其他数据（如LiveData、Flow等）
        // ...
    }
}

登出时获取对应ViewModel并调用清理方法：

val homeViewModel = navController.getViewModelStoreOwner(R.id.home_graph)?.let {
    ViewModelProvider(it)[HomeViewModel::class.java]
}
homeViewModel?.clearUserData()

注意事项 #

• getViewModelStoreOwner(graphId)仅在该navGraph被导航过之后才会返回非null值，所以直接遍历所有底部导航对应的graph ID即可覆盖所有可能的情况。
• 若使用Hilt的hiltNavGraphViewModels()，上述清除ViewModelStore的方法同样有效，因为Hilt基于ViewModelStore管理ViewModel实例。
• 确保登出后用户无法通过返回键回到旧页面，导航时的popUpTo配置是关键。

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