Activity后台切前台复用Fragment触发IllegalArgumentException问题咨询

这个问题我之前处理过，本质是系统恢复Fragment实例时和你的手动初始化/切换逻辑冲突导致的。当你用返回键结束应用时，系统会自动保存Activity和Fragment的状态；当你再次切前台启动应用，系统会尝试恢复之前的Fragment实例，但你的代码没有复用这些已恢复的实例，反而继续执行原有的add/attach逻辑，最终引发重复添加或状态不一致的异常。

具体解决方案如下： #

1. 在Activity onCreate阶段优先恢复已保存的Fragment实例

不要每次onCreate都直接new新的Fragment，先尝试从FragmentManager中恢复之前保存的实例，只有当实例不存在时再初始化：

private FragmentA fragmentA;
private FragmentB fragmentB;
private static final String TAG_FRAGMENT_A = "tag_fragment_a";
private static final String TAG_FRAGMENT_B = "tag_fragment_b";

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // 先恢复系统保存的Fragment实例
    if (savedInstanceState != null) {
        fragmentA = (FragmentA) getSupportFragmentManager().findFragmentByTag(TAG_FRAGMENT_A);
        fragmentB = (FragmentB) getSupportFragmentManager().findFragmentByTag(TAG_FRAGMENT_B);
    }

    // 实例不存在时再初始化
    if (fragmentA == null) {
        fragmentA = new FragmentA();
    }
    if (fragmentB == null) {
        fragmentB = new FragmentB();
    }

    // 首次启动（无状态恢复）时才执行初始add操作
    if (savedInstanceState == null) {
        getSupportFragmentManager().beginTransaction()
                .add(R.id.fragment_container, fragmentA, TAG_FRAGMENT_A)
                .commit();
    }
}

2. 优化BottomNavigation的切换逻辑，检查Fragment状态再操作

在切换Fragment时，不要假设当前Fragment的状态，先确认目标Fragment是否已经被添加到FragmentManager中，避免重复add或attach异常：

bottomNavigationView.setOnNavigationItemSelectedListener(item -> {
    FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
    Fragment currentFragment = getSupportFragmentManager().findFragmentById(R.id.fragment_container);

    switch (item.getItemId()) {
        case R.id.nav_item_a:
            if (currentFragment != fragmentA) {
                // 先detach当前显示的Fragment
                if (currentFragment != null) {
                    transaction.detach(currentFragment);
                }
                // 检查FragmentA是否已添加，未添加则add，已添加则attach
                if (!fragmentA.isAdded()) {
                    transaction.add(R.id.fragment_container, fragmentA, TAG_FRAGMENT_A);
                } else {
                    transaction.attach(fragmentA);
                }
            }
            break;
        case R.id.nav_item_b:
            if (currentFragment != fragmentB) {
                if (currentFragment != null) {
                    transaction.detach(currentFragment);
                }
                if (!fragmentB.isAdded()) {
                    transaction.add(R.id.fragment_container, fragmentB, TAG_FRAGMENT_B);
                } else {
                    transaction.attach(fragmentB);
                }
            }
            break;
    }
    transaction.commit();
    return true;
});

3. 额外注意事项

• 确保Fragment的onSaveInstanceState方法正确保存必要的状态数据，避免恢复后Fragment状态异常；
• 不要在onRestoreInstanceState中做不必要的Fragment操作，交给系统处理基础的实例恢复即可；
• 始终使用唯一的tag标记Fragment，方便后续通过findFragmentByTag准确获取实例。

这样修改后，当应用从后台切前台时，系统恢复的Fragment实例会被正确复用，不会再触发IllegalArgumentException异常。

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