使用popBackStack后无法再次打开CreateNotesFragment的问题排查

我正在开发一款笔记应用，期望用户在CreateNotesFragment按下返回键时保存笔记，并关闭该Fragment回到HomeFragment。我使用的代码如下：

activity?.onBackPressedDispatcher?.addCallback(this){
            saveNote()
            activity?.supportFragmentManager?.popBackStack()
        }

这段代码首次运行正常，但当我尝试再次打开CreateNotesFragment添加新笔记时，出现如下错误：

E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.example.lavanianotesapp, PID: 4952
    java.lang.IllegalArgumentException: Navigation action/destination com.example.lavanianotesapp:id/action_homeFragment_to_createNotesFragment cannot be found from the current destination Destination(com.example.lavanianotesapp:id/createNotesFragment) label=fragment_create_notes class=com.example.lavanianotesapp.UI.Fragments.CreateNotesFragment
        at androidx.navigation.NavController.navigate(NavController.kt:1540)
        at androidx.navigation.NavController.navigate(NavController.kt:1472)
        at androidx.navigation.NavController.navigate(NavController.kt:1454)
        at androidx.navigation.NavController.navigate(NavController.kt:1437)

我的导航图如下：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/homeFragment">

    <fragment
        android:id="@+id/homeFragment"
        android:name="com.example.lavanianotesapp.UI.Fragments.HomeFragment"
        android:label="fragment_home"
        tools:layout="@layout/fragment_home" >
        <action
            android:id="@+id/action_homeFragment_to_createNotesFragment"
            app:destination="@id/createNotesFragment" />
        <action
            android:id="@+id/action_homeFragment_to_editNotesFragment"
            app:destination="@id/editNotesFragment" />
    </fragment>
    <fragment
        android:id="@+id/createNotesFragment"
        android:name="com.example.lavanianotesapp.UI.Fragments.CreateNotesFragment"
        android:label="fragment_create_notes"
        tools:layout="@layout/fragment_create_notes" >
        <action
            android:id="@+id/action_createNotesFragment_to_homeFragment"
            app:destination="@id/homeFragment" />
        <action
            android:id="@+id/action_createNotesFragment_to_addLabelFragment"
            app:destination="@id/addLabelFragment" />
    </fragment>
    <fragment
        android:id="@+id/editNotesFragment"
        android:name="com.example.lavanianotesapp.UI.Fragments.EditNotesFragment"
        android:label="fragment_edit_notes"
        tools:layout="@layout/fragment_edit_notes" >
        <action
            android:id="@+id/action_editNotesFragment_to_homeFragment"
            app:destination="@id/homeFragment" />
        <action
            android:id="@+id/action_editNotesFragment_to_addLabelFragment"
            app:destination="@id/addLabelFragment" />
    </fragment>
    <fragment
        android:id="@+id/addLabelFragment"
        android:name="com.example.lavanianotesapp.UI.Fragments.AddLabelFragment"
        android:label="fragment_add_label"
        tools:layout="@layout/fragment_add_label" >
        <action
            android:id="@+id/action_addLabelFragment_to_createNotesFragment"
            app:destination="@id/createNotesFragment" />
        <action
            android:id="@+id/action_addLabelFragment_to_editNotesFragment"
            app:destination="@id/editNotesFragment" />
    </fragment>
</navigation>

我不理解为什么调用popBackStack()后无法再次打开CreateNotesFragment，是否有popBackStack的替代方案，或者我遗漏了什么？

问题原因 #

你混用了AndroidX Navigation组件的栈管理机制和原生FragmentManager.popBackStack()，直接调用popBackStack()会破坏Navigation组件内部的栈状态记录。Navigation会误以为当前页面还是CreateNotesFragment，而action_homeFragment_to_createNotesFragment只能从HomeFragment触发，因此抛出异常。

推荐实现方式 #

方式1：使用Navigation组件的导航action返回

直接调用导航图中定义的返回action，让Navigation自行管理栈状态：

activity?.onBackPressedDispatcher?.addCallback(viewLifecycleOwner) {
    saveNote()
    // 调用预定义的返回Home的action
    findNavController().navigate(R.id.action_createNotesFragment_to_homeFragment)
}

方式2：使用Navigation的navigateUp方法

navigateUp()相当于Navigation版本的popBackStack()，会自动同步内部栈状态：

activity?.onBackPressedDispatcher?.addCallback(viewLifecycleOwner) {
    saveNote()
    // 优先让Navigation处理返回，若已到根页面则关闭Activity
    if (!findNavController().navigateUp()) {
        activity?.finish()
    }
}

这里用viewLifecycleOwner作为回调的生命周期所有者，能避免Fragment销毁后回调内存泄漏。

额外注意事项 #

• 打开CreateNotesFragment时，必须通过Navigation的navigate(R.id.action_homeFragment_to_createNotesFragment)方法，不能直接用FragmentManager手动添加Fragment，否则Navigation的栈状态会混乱。
• 若需要从HomeFragment多次打开CreateNotesFragment，保持导航图中action_homeFragment_to_createNotesFragment的默认配置即可，无需额外设置popUpTo。

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