原生移动开发 / 系统课时
导航状态保存与恢复
导航状态保存与恢复
本节解决 Compose 导航里最常见的“切换后丢位置”和“重复点击堆页面”问题:保存顶层目的地的返回栈、恢复已访问状态,并把页面 UI 状态与导航状态分开处理,使重选、返回和配置变化都有明确行为。
学习目标
- 区分返回栈状态与页面 UI 状态各由谁保存
- 使用
saveState、restoreState和launchSingleTop管理顶层导航 - 为重选当前入口和屏幕旋转定义可预测的恢复行为
先区分导航状态与页面状态
Navigation 保存的是“去过哪些目的地、返回时回到哪里”这类返回栈信息;输入框文本、筛选条件等页面状态则应由 Compose 或 ViewModel 保存。把两者混在一起,常见结果是返回栈恢复了,但页面内容重置,或者为了保留输入而手工复制整个导航历史。
对于可放进保存状态机制的小型 UI 数据,可使用 rememberSaveable;业务数据、网络结果和可重新加载的大对象应留在 ViewModel 或数据层,而不是塞进导航参数或保存状态包。
保存并恢复顶层返回栈
底部导航通常需要在多个顶层入口之间保留各自的位置。切换入口时,popUpTo(...){ saveState = true } 保存被弹出的栈,restoreState = true 在再次进入时恢复它,launchSingleTop = true 则避免当前顶层目标被重复压入栈顶。

片段示例:以下辅助函数用于已有的 Compose Navigation 项目;reselect 由底部导航项是否已经处于选中状态决定。
import androidx.compose.material3.OutlinedTextField
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.navigation.NavGraph.Companion.findStartDestination
import androidx.navigation.NavHostController
fun NavHostController.selectTopLevel(route: String, reselect: Boolean) {
if (reselect) {
// 常见产品语义:再次点击当前入口时回到该入口根页。
popBackStack(route, inclusive = false)
return
}
navigate(route) {
popUpTo(graph.findStartDestination().id) {
// 切走前保存当前入口被弹出的返回栈与可保存状态。
saveState = true
}
launchSingleTop = true
restoreState = true
}
}
@Composable
fun SearchScreen(modifier: Modifier = Modifier) {
// 小型页面状态交给 rememberSaveable,应对 Activity 重建。
var query by rememberSaveable { mutableStateOf("") }
OutlinedTextField(
value = query,
onValueChange = { query = it },
modifier = modifier
)
}预期结果:从 Home 的详情页切到 Search,再切回 Home 时会恢复先前保存的 Home 栈;重复进入同一顶层目标不会额外堆叠副本。Search 输入框中的文本在常见 Activity 重建场景下也能恢复。
明确定义重选与返回行为
“重选当前 Tab”没有唯一正确答案,必须由产品语义决定。上面的实现选择了常见规则:当前入口已选中时执行 popBackStack(route, inclusive = false),把该入口之上的详情页弹出,回到入口根页。
如果你的产品要求“重选后仍停在原位置”,则不要执行这个分支,继续使用 launchSingleTop 避免重复压栈即可。系统返回键则应让 NavController 按当前活动返回栈正常弹出,不要再维护一套平行的自定义页面栈。
配置变化与恢复边界
rememberNavController() 应在组合中稳定创建,不要因为普通状态变化反复重建控制器。页面里需要跨配置变化保存的小状态使用 rememberSaveable;需要跨页面共享或从数据源恢复的业务状态优先交给 ViewModel。
验证时至少覆盖三组动作:进入详情后切换顶层入口再切回、连续重选当前入口、在输入内容后旋转屏幕。三组行为分别对应返回栈恢复、重选策略和页面状态恢复,分开测试比只看“页面还在不在”更容易定位问题。