Android Fragment回栈异常：返回时A与D重叠的原因及解决方法

场景描述 #

现有4个Fragment：A、B、C、D，通过replace方法实现页面跳转，调用逻辑如下：

• A 替换为 B：调用transaction.addToBackStack(fragment.tag)
• B 替换为 C、C 替换为 D：未调用addToBackStack
  跳转流程：A -> replace + addToBackStack -> B -> replace -> C -> replace -> D

预期行为 #

从B、C、D任一页面点击返回键，均回到Fragment A。

实际异常 #

• B替换为C的事务未加入回栈，但Fragment B并未被销毁；
• 从C或D点击返回时，B才被销毁，但Fragment D未被销毁，导致A与D重叠显示。

官方文档参考 #

If you don't call addToBackStack() when you perform a transaction that removes a fragment, then the removed fragment is destroyed when the transaction is committed, and the user cannot navigate back to it. If you do call addToBackStack() when removing a fragment, then the fragment is only STOPPED and is later RESUMED when the user navigates back.

（翻译：执行移除Fragment的事务时，若未调用addToBackStack()，被移除的Fragment会在事务提交时销毁，用户无法返回至该Fragment；若调用了addToBackStack()，则Fragment仅会被停止，用户返回时会恢复。）

相关代码 #

public fun transitionFragment(fragment: Fragment, addToBackstack: Boolean) {
    val transaction = supportFragmentManager.beginTransaction()
    transaction.replace(R.id.nav_host_fragment_content_main, fragment);
    if (addToBackstack) {
        transaction.addToBackStack(fragment.tag)
    }
    transaction.commit()
}

调用方式：

transitionFragment(fragA, false)
transitionFragment(fragB, true)
transitionFragment(fragC, false)
transitionFragment(fragD, false)

异常原因 #

1. B未被立即销毁的原因：
   FragmentManager的回栈是按事务而非Fragment实例管理的。B→C的replace事务未加入回栈，但B属于已入栈的A→B事务，只有当这个入栈事务被弹出（返回键触发回退）时，B才会被销毁，因此替换为C时B不会立即消失。

2. A与D重叠的原因：
   从D点击返回键时，FragmentManager会弹出回栈顶部的A→B事务，回退到A的状态。但D是通过无回栈的replace事务添加的，该事务未被记录在回栈中，导致D的实例未被移除，最终A重新显示后与D重叠。

实现预期返回行为的方案 #

方式一：跳转时清空回栈 #

修改transitionFragment方法，在跳转到C、D时清空回栈，确保返回直接指向A：

public fun transitionFragment(fragment: Fragment, addToBackstack: Boolean, clearBackStack: Boolean = false) {
    val transaction = supportFragmentManager.beginTransaction()
    transaction.replace(R.id.nav_host_fragment_content_main, fragment)
    
    if (clearBackStack) {
        // 清空所有回栈事务，回到初始状态（即A的状态）
        supportFragmentManager.popBackStack(null, FragmentManager.POP_BACK_STACK_INCLUSIVE)
    } else if (addToBackstack) {
        transaction.addToBackStack(fragment.tag)
    }
    transaction.commit()
}

调用方式：

transitionFragment(fragA, false)
transitionFragment(fragB, true)
transitionFragment(fragC, false, true)
transitionFragment(fragD, false, true)

方式二：重写返回键逻辑 #

在宿主Activity中重写返回事件，强制从B、C、D返回时回到A：

override fun onBackPressed() {
    val currentFrag = supportFragmentManager.findFragmentById(R.id.nav_host_fragment_content_main)
    if (currentFrag is BFragment || currentFrag is CFragment || currentFrag is DFragment) {
        // 清空回栈并替换为A
        supportFragmentManager.popBackStack(null, FragmentManager.POP_BACK_STACK_INCLUSIVE)
        supportFragmentManager.beginTransaction()
            .replace(R.id.nav_host_fragment_content_main, AFragment())
            .commit()
    } else {
        super.onBackPressed()
    }
}

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