Android onBackPressed异常：Fragment叠加显示的问题排查与修复

问题现象 #

导航流程为A→B→C→B→C时，按返回键出现异常：先显示B与C重叠，再显示A与C重叠，最后直接退出App，不符合预期的C→B→A→退出的回退逻辑。

原因拆解 #

1. 回退栈与显示状态不匹配：现有逻辑仅在首次创建Fragment实例时将其加入回退栈，复用已有实例时不操作回退栈。当重复进入已存在的Fragment（如从C切回B），回退栈仍保留旧条目序列[A,B,C]，但当前显示的是复用的B，导致popBackStack时会回到旧的Fragment实例，与当前显示内容重叠。
2. 未维护回退栈唯一性：同一类型的Fragment在回退栈中存在多条旧条目，未清理冗余历史，导致回退路径混乱。
3. 字符串判断逻辑错误：使用!==引用判断字符串是否相等，存在潜在逻辑误差，应改为值判断!=。

修复方案 #

核心逻辑调整 #

• 切换Fragment时，先检查回退栈中是否存在目标Fragment的条目，若存在则清理该条目之后的所有冗余历史，保证回退栈仅保留最新的导航路径。
• 统一回退栈添加逻辑：仅当回退栈中无目标Fragment条目时，才将其加入回退栈，避免重复添加。
• 修正字符串相等判断逻辑，确保类型匹配判断准确。

修改后的replaceFragment函数 #

fun replaceFragment(
    destinationFragment: Fragment,
    currentFragment: String,
    title: String,
    initialLaunch: Boolean = false
) {
    val destTag = destinationFragment.javaClass.simpleName
    val existingFragment = fragmentManager.findFragmentByTag(destTag)
    val isSameFragment = destTag == currentFragment

    if (!isSameFragment || initialLaunch) {
        val transaction = fragmentManager.beginTransaction()
        var needAddToBackStack = true

        // 清理回退栈中目标Fragment之后的所有条目
        val stackCount = fragmentManager.backStackEntryCount
        for (i in stackCount - 1 downTo 0) {
            val entry = fragmentManager.getBackStackEntryAt(i)
            if (entry.name == destTag) {
                // 弹出该条目之后的所有内容，保留该条目本身
                fragmentManager.popBackStack(entry.id, 0)
                needAddToBackStack = false
                break
            }
        }

        if (existingFragment != null) {
            // 复用已存在的Fragment实例
            transaction.replace(R.id.frame_layout, existingFragment, destTag)
        } else {
            // 创建并添加新的Fragment实例
            transaction.replace(R.id.frame_layout, destinationFragment, destTag)
        }

        // 仅当回退栈中无目标条目时，加入回退栈
        if (needAddToBackStack) {
            transaction.addToBackStack(destTag)
        }

        transaction.commit()
    }
}

验证修复后的导航流程 #

• A→B→C：回退栈为[A,B,C]，按返回键依次回到B、A，最后退出。
• A→B→C→B：清理回退栈中B之后的C条目，回退栈变为[A,B]，显示复用的B；按返回键回到A，再退出。
• A→B→C→B→C：回退栈中无最新的C条目，复用C实例并加入回退栈，回退栈变为[A,B,C]；按返回键依次回到B、A，最后退出，完全符合预期。

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