Jetpack Compose如何保存恢复导航状态？代码不生效怎么办

你用的saveState = true+restoreState = true是导航组件提供的标准状态保存逻辑，失效基本都是前置条件不满足或配置遗漏导致，按下面的步骤检查即可：

必须满足的前置条件 #

这几项是逻辑生效的基础，缺一项都无法正常工作：

• 所有导航目的地的route必须是唯一固定常量，不要用带动态可变参数的route作为底部导航切换目标，否则状态匹配会失效
• Navigation Compose依赖版本不低于2.4.0，低版本存在多个状态保存相关的已知bug，建议直接使用当前官方稳定版
• 页面自身的可观察状态必须符合Compose状态保存规则：需要留存的状态用rememberSaveable持有，列表滚动位置等组件自带状态必须用官方提供的remember方法（比如rememberLazyListState本身已实现状态序列化保存，不要自己手动new状态实例）
• NavController实例必须用rememberNavController()在组合层级足够高的位置持有，不能在重组过程中重复创建新的NavController实例

标准实现代码 #

底部导航切换的正确跳转逻辑要补全launchSingleTop配置，避免重复创建目的地实例，同时建议用导航图的startDestination作为popUpTo锚点，比直接传graph.id兼容性更好：

navController.navigate(targetRoute) {
    popUpTo(navController.graph.findStartDestination().id) {
        saveState = true
    }
    launchSingleTop = true
    restoreState = true
}

常见问题排查清单 #

按顺序核对即可定位90%以上的失效问题：

1. 排查页面自身状态持有方式
   不要手动创建无状态保存能力的状态实例，比如直接写val listState = LazyListState()会导致列表位置永远无法恢复，必须替换为val listState = rememberLazyListState()；自定义的页面状态要么用rememberSaveable包裹，要么存在ViewModel的SavedStateHandle里。
2. 排查导航route配置
   不要给不同导航目的地配置重复route，不要在底部导航切换的route里拼接每次跳转都会变化的动态参数，否则保存的状态会被覆盖或匹配失败。
3. 排查popUpTo配置
   不要在popUpTo里加inclusive = true配置，该配置会直接把目标目的地从返回栈中移除，对应的已保存状态也会被同步清空，无法触发恢复逻辑。
4. 排查自定义的状态清空逻辑
   不要在页面的onDispose或者ViewModel的onCleared回调里手动清空页面数据，这类逻辑会直接覆盖导航组件恢复的状态，如有必要需要加状态判断区分是正常退出还是后台暂存。
5. 排查系统配置影响
   如果开了开发者选项里的「不保留活动」开关，系统会强制销毁离开的页面，这种场景下需要单独适配SavedStateHandle的持久化逻辑，不属于导航组件默认状态保存的覆盖范围。

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