Compose Navigation底部导航状态未稳定恢复及ViewModel重建问题求助

使用Compose Navigation搭配底部导航栏时，返回之前选中的Tab，状态并非总能恢复。当前使用的导航配置如下：

val topLevelNavOptions = navOptions {
  popUpTo(navController.graph.findStartDestination().id) {
    saveState = true
  }
  launchSingleTop = true
  restoreState = true
}

随机切换屏幕时会丢失状态，且Hilt注入的ViewModel会生成新实例。此问题可在nowinandroid应用中复现：克隆仓库后，在InterestsViewModel.kt中添加以下代码：

override fun onCleared() {
  super.onCleared()
  Log.d("asd", "onCleared")
}

随机点击底部导航切换屏幕，上述日志有时会被打印。

编辑：已确认这是Compose Navigation的Bug，已提交相关报告。

原因分析 #

这是Compose Navigation的已知Bug，核心问题是快速切换底部导航Tab时，导航组件的状态保存/恢复逻辑出现偶发异常，没有正确保留之前Tab对应的页面状态，导致ViewModel被销毁（触发onCleared），再次切回时会重新创建ViewModel并丢失原有状态。

临时解决办法 #

• 添加导航延迟：给底部导航的点击事件加个短延迟（比如100ms），避免快速连续切换触发异常逻辑。示例代码：

// 底部导航项点击时执行
LaunchedEffect(Unit) {
  delay(100)
  navController.navigate(route, topLevelNavOptions)
}

• 手动缓存关键状态：在ViewModel里把重要状态存到本地（比如DataStore、SharedPreferences），初始化时再读取恢复。示例：

class InterestsViewModel @Inject constructor(
  private val dataStore: DataStore<Preferences>
) : ViewModel() {
  private val _selectedTopics = MutableStateFlow(emptySet<String>())
  val selectedTopics = _selectedTopics.asStateFlow()

  init {
    viewModelScope.launch {
      // 从DataStore恢复状态
      dataStore.data.map { it[SELECTED_TOPICS_KEY] ?: emptySet() }
        .collect { _selectedTopics.value = it }
    }
  }

  fun updateSelectedTopics(topics: Set<String>) {
    _selectedTopics.value = topics
    viewModelScope.launch {
      // 保存状态到DataStore
      dataStore.edit { it[SELECTED_TOPICS_KEY] = topics }
    }
  }

  override fun onCleared() {
    super.onCleared()
    Log.d("asd", "onCleared")
  }
}

• 自定义导航栈管理：如果对状态稳定性要求极高，可以自己维护顶部页面的状态，比如用Map存储每个Tab对应的页面状态，切换时手动恢复。不过这种方式复杂度较高，按需使用即可。

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