Android Fragment按一次返回键未正确回退、需按两次才能返回上一级的问题修复

• 回退栈结构和事务逻辑存在缺陷
  冷启动添加根CountryListFragment时，仅执行了add操作未关联回退栈；后续从列表页跳转统计页时，replace操作虽然调用了addToBackStack(null)，但因为事务设置了setReorderingAllowed(true)，所有Fragment事务都是异步排队执行的。
  系统默认返回事件由OnBackPressedDispatcher统一分发，FragmentManager会注册高优先级返回回调，检测到回退栈深度大于0时自动触发一次异步popBackStack()。第一次按返回键时，弹栈事务被排到队列尾部，执行过程会短暂触发页面闪烁；但因为根Fragment未纳入回退栈管理，弹栈完成后栈深度直接归零，系统判定已到栈底，没有完整执行页面恢复逻辑，就出现了“闪一下仍停留在统计页”的效果。直到第二次按返回时，之前排队的弹栈事务已经执行完成，才会真正切回列表页。
• 临时修复代码和系统返回逻辑产生了冗余冲突
  你重写的onBackPressed里，手动调用popBackStackImmediate()已经同步完成了弹栈和页面切换，再调用super.onBackPressed()时，会再次触发OnBackPressedDispatcher的全量分发流程，相当于和FragmentManager自带的返回回调形成了逻辑重叠。虽然碰巧能实现一次返回就回退的效果，但逻辑是冗余的，还可能引发回退栈计数错误、Fragment实例重复创建等异常。

• 调整Fragment事务逻辑，对齐回退栈的设计规范
  明确回退栈的入栈规则：仅在从低层级页面跳转到高层级页面时，把跳转事务压入回退栈，不要对所有replace操作无脑加addToBackStack：

  private fun setCountryFragment() {
      supportFragmentManager.commit {
          setReorderingAllowed(true)
          // 根Fragment是页面初始状态，不需要入栈
          add<CountryListFragment>(R.id.fragment_container_view)
      }
  }
  
  // 拆分原来的changeFragment方法，仅保留跳转统计页的逻辑
  private fun navigateToStatistic(arg: String) {
      val statisticFragment = CountryStatisticFragment.newInstance(arg)
      supportFragmentManager.commit {
          setReorderingAllowed(true)
          replace(R.id.fragment_container_view, statisticFragment)
          // 仅跳转时入栈，用Fragment类名作为栈标识，方便后续精准弹栈
          addToBackStack(statisticFragment::class.java.name)
      }
  }
  

  移除原changeFragment里的反向分支（从统计页切回列表页的逻辑）：这个方向根本不需要手动写代码，按返回键时系统会自动弹出统计页的栈记录，恢复之前的列表页实例，不会创建新的列表页，也不会出现重复入栈的问题。
• 移除冗余的onBackPressed重写逻辑
  如果不需要特殊的返回拦截（比如统计页二次确认退出），直接删掉之前重写的onBackPressed方法，让FragmentManager自身的返回回调处理回退逻辑即可。
  如果确实需要拦截返回事件，要通过OnBackPressedDispatcher注册回调，不要直接重写onBackPressed：

  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.id.activity_main)
  
      // 注册返回拦截逻辑
      onBackPressedDispatcher.addCallback(this) {
          val currentFragment = supportFragmentManager.findFragmentById(R.id.fragment_container_view)
          // 仅在统计页时拦截返回，做自定义逻辑
          if (currentFragment is CountryStatisticFragment) {
              // 这里可以加二次确认弹框等业务逻辑
              // 处理完成后手动弹栈即可
              supportFragmentManager.popBackStack()
          } else {
              // 到列表页时，移除拦截回调，让系统默认处理返回（退出App）
              remove()
              onBackPressedDispatcher.onBackPressed()
          }
      }
  
      if (savedInstanceState == null) {
          setCountryFragment()
      }
  }
  

• popBackStack()是异步操作，popBackStackImmediate()是同步操作，不要在同一流程里混用两种弹栈方式，不然很容易出现事务队列执行顺序混乱、页面闪烁的问题。
• 回退栈的深度要和页面层级一一对应：每一次正向跳转入栈一次，一次返回就弹一次栈，不要出现栈深度和实际页面数不匹配的情况，不然必然会出现多次返回才能生效的异常。

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