Navigation Graph中Fragment无法弹出导致返回异常的问题

核心问题分析 #

你遇到的循环跳转问题，本质是Fragment1已经被加入回退栈，自动跳转时的popUpTo配置没正确生效，导致回退栈里仍保留Fragment1实例，返回时触发Fragment1的跳转逻辑又回到Fragment2。

解决方案1：将自动跳转逻辑移到宿主Activity（推荐） #

把判断isUserRegistered的逻辑从Fragment1的onCreateView移到宿主Activity的onCreate方法中，这样可以在导航组件初始化时直接决定启动页面，Fragment1根本不会被添加到回退栈，从根源避免返回问题。

代码示例：

// 宿主Activity的onCreate方法
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val navController = findNavController(R.id.nav_host_fragment)
    val sharedPrefs = getSharedPreferences("your_prefs_name", MODE_PRIVATE)
    val isRegistered = sharedPrefs.getBoolean("isUserRegistered", false)

    if (isRegistered) {
        // 直接跳转到Fragment2，同时清空回退栈中所有页面
        val navOptions = NavOptions.Builder()
            .setPopUpTo(R.id.fragment1, true) // 这里填Fragment1的导航ID
            .build()
        navController.navigate(R.id.fragment2, null, navOptions)
    }
}

解决方案2：修正Fragment1内的跳转逻辑与导航配置 #

如果必须在Fragment1中处理自动跳转，需要做两处调整：

1. 添加跳转标记，避免重复触发
   在Fragment1中定义一个变量标记是否已经执行过跳转，防止每次onCreateView触发时重复跳转：

   class Fragment1 : Fragment() {
       private var hasNavigated = false
   
       override fun onCreateView(
           inflater: LayoutInflater,
           container: ViewGroup?,
           savedInstanceState: Bundle?
       ): View? {
           if (!hasNavigated) {
               val sharedPrefs = requireContext().getSharedPreferences("your_prefs_name", MODE_PRIVATE)
               val isRegistered = sharedPrefs.getBoolean("isUserRegistered", false)
               if (isRegistered) {
                   hasNavigated = true
                   // 跳转时配置正确的NavOptions
                   val navOptions = NavOptions.Builder()
                       .setPopUpTo(R.id.fragment1, true)
                       .build()
                   findNavController().navigate(R.id.action_fragment1_to_fragment2, null, navOptions)
               }
           }
           return inflater.inflate(R.layout.fragment1, container, false)
       }
   }
   

2. 确保导航图中action的配置正确
   检查导航图中从Fragment1到Fragment2的action，确认popUpTo指向Fragment1的ID，且popUpToInclusive="true"：

   <fragment
       android:id="@+id/fragment1"
       android:name="com.yourpackage.Fragment1"
       android:label="Fragment1">
       <action
           android:id="@+id/action_fragment1_to_fragment2"
           app:destination="@id/fragment2"
           app:popUpTo="@id/fragment1"
           app:popUpToInclusive="true"/>
   </fragment>
   

为什么之前的配置不生效？ #

Fragment的onCreateView执行时，Fragment已经被添加到回退栈中，此时调用跳转即使设置了popUpTo，部分场景下导航组件无法及时移除回退栈中的Fragment1实例，导致回退栈仍保留该页面，返回时触发Fragment1的跳转逻辑形成循环。

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