如何修复ViewPager2中FragmentManager已在执行事务的异常

问题复现 #

使用BottomNavigationView控制ViewPager2切换页面，应用正常运行但偶尔崩溃，抛出异常：

java.lang.IllegalStateException: FragmentManager is already executing transactions

错误原因分析 #

从错误栈可以看出，崩溃发生在FragmentStateAdapter更新Fragment生命周期状态时，此时FragmentManager正在执行其他事务，导致冲突。核心诱因有两个：

• 提前实例化所有Fragment并持有引用，这些Fragment的生命周期状态可能和ViewPager2的管理逻辑冲突
• 切换ViewPager页面时的操作，和FragmentManager正在进行的事务（比如Fragment的attach/detach）并行触发

另外你提到的getChildFragmentManager()，它的适用场景是在Fragment内部管理子Fragment，当前是Activity中使用ViewPager2，用getSupportFragmentManager()是正确的，不需要更换。

解决方案 #

1. 避免提前实例化Fragment #

不要在onCreate中提前创建所有Fragment实例，而是在FragmentStateAdapter的createFragment()方法中按需创建新实例，让ViewPager2自己管理Fragment的生命周期和实例：

private static class ViewPagerAdapter extends FragmentStateAdapter {
    public ViewPagerAdapter(@NonNull FragmentManager fragmentManager, @NonNull Lifecycle lifecycle) {
        super(fragmentManager, lifecycle);
    }

    @NonNull
    @Override
    public Fragment createFragment(int position) {
        switch (position) {
            case 0: return new ATableTime();
            case 1: return new BJournal();
            case 2: return new LibraryFragment();
            case 3: return new ListFragment();
            default: throw new IllegalArgumentException("Invalid position: " + position);
        }
    }

    @Override
    public int getItemCount() {
        return 4;
    }
}

2. 确保页面切换操作在FragmentManager空闲时执行 #

在BottomNavigationView的选中监听中，把ViewPager的切换操作放到主线程消息队列的下一个循环，避免和当前正在执行的Fragment事务冲突：

void action(){
    bNavView.setOnItemSelectedListener(item -> {
        int targetPosition = switch (item.getItemId()) {
            case R.id.tableTime -> 0;
            case R.id.journal -> 1;
            case R.id.library -> 2;
            case R.id.more -> 3;
            default -> viewPager.getCurrentItem();
        };
        // 用post延迟执行，避免和当前Fragment事务冲突
        viewPager.post(() -> viewPager.setCurrentItem(targetPosition, false));
        return true;
    });
}

代码优化建议 #

• 用常量管理页面索引，避免硬编码数字，提升可维护性：

private static final int PAGE_TIMETABLE = 0;
private static final int PAGE_JOURNAL = 1;
private static final int PAGE_LIBRARY = 2;
private static final int PAGE_MORE = 3;

• 简化BottomNavigationView的监听逻辑，用Map映射itemId到页面索引：

private final Map<Integer, Integer> itemPositionMap = new HashMap<Integer, Integer>() {{
    put(R.id.tableTime, PAGE_TIMETABLE);
    put(R.id.journal, PAGE_JOURNAL);
    put(R.id.library, PAGE_LIBRARY);
    put(R.id.more, PAGE_MORE);
}};

void action(){
    bNavView.setOnItemSelectedListener(item -> {
        Integer targetPosition = itemPositionMap.get(item.getItemId());
        if (targetPosition != null) {
            viewPager.post(() -> viewPager.setCurrentItem(targetPosition, false));
        }
        return true;
    });
}

• 初始化时设置联动状态，确保初始页面和BottomNavigationView选中项一致：

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

    viewPager.setUserInputEnabled(false);
    ViewPagerAdapter viewPagerAdapter = new ViewPagerAdapter(getSupportFragmentManager(), getLifecycle());
    viewPager.setAdapter(viewPagerAdapter);

    // 初始化选中第一个项
    bNavView.setSelectedItemId(R.id.tableTime);
    action();
}

• 避免持有Fragment实例引用，让ViewPager2完全管理Fragment的创建和销毁，减少生命周期冲突风险。

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