使用Jetpack Navigation时setGraph切换导航图崩溃问题求助

问题场景 #

1. 应用启动显示登录导航图（Graph A），校验通过后用setGraph切换到带BottomNavigationView的主内容导航图（Graph B），清除Graph A返回栈；
2. 进入Graph B1的起始Fragment 1；
3. 从Fragment 1导航到嵌套的Fragment 2；
4. 点击底部导航栏切换到Graph B3（显示Fragment 4）；
5. 点击按钮调用setGraph切换回Graph A，应用崩溃。

报错信息 #

IllegalStateException: Restore State failed: destination Fragment2 cannot be found from the current destination Fragment4

问题原因 #

NavController会保存返回栈状态，从Graph B1的Fragment2切换到Graph B3的Fragment4时，返回栈仍保留Fragment2的记录。此时调用setGraph切换到Graph A，系统尝试恢复之前的状态，但当前导航图（Graph B3）和目标导航图（Graph A）都找不到Fragment2这个目的地，触发非法状态异常。Graph B2无此问题，是因为B2的操作未产生跨图的深层返回栈记录。

解决方法 #

方法一：切换前清空返回栈

调用setGraph切换到Graph A前，先清空Graph B的返回栈，避免残留深层页面状态：

// 清空Graph B的所有返回栈
navController.popBackStack(R.id.graph_b_start_destination, true)
// 切换到Graph A
navController.setGraph(R.navigation.graph_a)

若使用Navigation 2.4及以上版本，可直接调用更简洁的API：

navController.clearBackStack()
navController.setGraph(R.navigation.graph_a)

方法二：用navigate跳转替代setGraph

将Graph A作为嵌套导航图加入主导航结构，通过navigate跳转并清空栈，规避状态恢复冲突：

val navOptions = NavOptions.Builder()
    .setPopUpTo(R.id.graph_b, true) // 清空Graph B的所有栈
    .build()
navController.navigate(R.id.graph_a, null, navOptions)

这种方式更贴合Navigation设计规范，能避免setGraph带来的状态问题。

验证 #

按上述方法修改后，从Graph B3切换回Graph A时返回栈已清空，系统不会再尝试恢复不存在的Fragment2状态，应用可正常跳转。

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