Android Navigation Component：跳转目标页时恢复完整导航回退栈

这个问题我之前做项目时也踩过坑——直接用navController.navigate()跳转到目标页面，确实只会生成EntryPoint -> C的短栈，没法保留中间的回退路径。要恢复完整的EntryPoint -> A -> B -> C回退栈，有两种靠谱的方案，根据你的需求选就行：

方案一：使用saveState()和restoreState()（推荐，简单高效） #

从Jetpack Navigation 2.4.0版本开始，官方提供了直接保存和恢复导航栈状态的API，这是最省心的方式：

1. 保存导航栈状态 #

当用户在C页面关闭应用时，调用navController.saveState()获取整个导航栈的状态，然后把这个状态序列化后存在SharedPreferences或者本地文件里：

// 获取导航栈状态
val navState = navController.saveState()
// 用Gson把状态转成字符串（需要添加Gson依赖）
val navStateJson = Gson().toJson(navState)
// 保存到SharedPreferences
val sharedPrefs = context.getSharedPreferences("nav_prefs", Context.MODE_PRIVATE)
sharedPrefs.edit().putString("saved_nav_state", navStateJson).apply()

2. 恢复导航栈状态 #

当用户重新打开应用时，读取保存的状态字符串，反序列化后调用navController.restoreState()：

val sharedPrefs = context.getSharedPreferences("nav_prefs", Context.MODE_PRIVATE)
val navStateJson = sharedPrefs.getString("saved_nav_state", null)
if (navStateJson != null) {
    val navState = Gson().fromJson(navStateJson, NavController.State::class.java)
    // 确保NavController已经关联了导航图后再恢复
    navController.restoreState(navState)
}

这样不仅能恢复完整的回退栈，连每个页面的参数状态也能一并恢复，非常方便。

方案二：手动构建回退栈（适合低版本Navigation） #

如果你的项目还在用低于2.4.0的Navigation版本，可以手动构建回退栈：

1. 保存导航栈的目的地ID列表 #

在用户退出C页面时，把回退栈里所有目的地的ID存起来：

// 获取回退栈里所有目的地的ID
val navStackIds = navController.backQueue.map { it.destination.id }
// 把列表转成逗号分隔的字符串保存
val stackString = navStackIds.joinToString(",")
val sharedPrefs = context.getSharedPreferences("nav_prefs", Context.MODE_PRIVATE)
sharedPrefs.edit().putString("saved_nav_stack", stackString).apply()

2. 手动逐个导航构建栈 #

重启应用时，读取保存的ID列表，先回到起始页，再依次导航到每个中间页，最后到C页面：

val sharedPrefs = context.getSharedPreferences("nav_prefs", Context.MODE_PRIVATE)
val stackString = sharedPrefs.getString("saved_nav_stack", null)
if (stackString != null) {
    val navStackIds = stackString.split(",").map { it.toInt() }
    // 先回到起始页（EntryPoint），保留起始页在栈中
    navController.popBackStack(navStackIds.first(), false)
    // 从第二个目的地开始，逐个导航
    for (i in 1 until navStackIds.size) {
        val destId = navStackIds[i]
        // 使用launchSingleTop避免重复创建页面实例
        val navOptions = NavOptions.Builder()
            .setLaunchSingleTop(true)
            .build()
        navController.navigate(destId, null, navOptions)
    }
}

这种方法需要确保每个目的地之间有对应的导航动作（action），或者直接用目的地ID导航（如果没有action的话）。

注意事项 #

• 如果你用方案一，记得添加Gson依赖（或者用其他序列化工具），同时要确保NavController已经和导航图绑定后再调用restoreState()，比如在onViewCreated()或者onStart()里执行恢复逻辑。
• 无论用哪种方案，都要在用户正常退出应用时（比如onPause()或者onStop()）保存状态，避免异常崩溃时丢失。

内容的提问来源于stack exchange，提问作者Archie G. Quiñones