如何解决FragmentStatePagerAdapter重新排序Fragment时的bug？

我之前也踩过这个FragmentStatePagerAdapter的坑，太懂你不想每次调用notifyDatasetChanged()就重建所有Fragment的心情——不仅费性能，还容易丢状态。针对这个问题，我整理了几个实用的解决方案，你可以根据自己的场景选择：

1. 精准控制getItemPosition()的返回值 #

不要无条件返回POSITION_NONE，而是根据数据的实际变化来判断某个位置的Fragment是否需要更新。核心思路是给每个数据源项添加唯一标识（比如ID），在getItemPosition()中对比当前Fragment绑定的标识和新数据对应位置的标识：

@Override
public int getItemPosition(@NonNull Object object) {
    YourFragment fragment = (YourFragment) object;
    long fragmentItemId = fragment.getBoundItemId(); // 假设Fragment有方法返回绑定数据的ID
    int currentPosition = getCurrentPositionForItemId(fragmentItemId);

    if (currentPosition == -1) {
        // 对应数据已被移除，需要销毁该Fragment
        return POSITION_NONE;
    }

    // 检查当前Fragment的位置是否匹配新数据中的位置
    // 如果匹配且数据未变化，返回POSITION_UNCHANGED；否则返回POSITION_NONE
    long newItemId = mDataSource.get(currentPosition).getId();
    return fragmentItemId == newItemId ? POSITION_UNCHANGED : POSITION_NONE;
}

// 辅助方法：根据数据ID找到它在新数据集里的位置
private int getCurrentPositionForItemId(long itemId) {
    for (int i = 0; i < mDataSource.size(); i++) {
        if (mDataSource.get(i).getId() == itemId) {
            return i;
        }
    }
    return -1;
}

这种方式只会在对应位置的数据真的变化时，才会重建该Fragment，其他未变化的Fragment会保持原样。

2. 手动维护Fragment缓存，实现复用逻辑 #

在Adapter里维护一个Fragment的缓存集合，当数据集变化时，优先复用已有Fragment并更新其数据，而不是直接重建：

private SparseArray<YourFragment> mFragmentCache = new SparseArray<>();

@Override
public Fragment getItem(int position) {
    YourFragment fragment = mFragmentCache.get(position);
    if (fragment == null) {
        // 没有缓存时创建新Fragment
        fragment = YourFragment.newInstance(mDataSource.get(position));
        mFragmentCache.put(position, fragment);
    } else {
        // 复用已有Fragment，更新其数据
        fragment.updateData(mDataSource.get(position));
    }
    return fragment;
}

@Override
public int getItemPosition(@NonNull Object object) {
    YourFragment fragment = (YourFragment) object;
    int newPosition = getCurrentPositionForItemId(fragment.getBoundItemId());
    
    if (newPosition == -1) {
        // 数据已被移除，返回POSITION_NONE销毁Fragment
        return POSITION_NONE;
    }

    // 如果Fragment的位置未变化，返回POSITION_UNCHANGED；否则返回新位置
    int cachedPosition = mFragmentCache.keyAt(mFragmentCache.indexOfValue(fragment));
    return cachedPosition == newPosition ? POSITION_UNCHANGED : newPosition;
}

// 辅助方法：根据数据ID找到新位置
private int getCurrentPositionForItemId(long itemId) {
    for (int i = 0; i < mDataSource.size(); i++) {
        if (mDataSource.get(i).getId() == itemId) {
            return i;
        }
    }
    return -1;
}

这种方式能最大程度复用已有Fragment，仅在必要时更新数据或重建，性能更优。

3. 迁移到ViewPager2 + FragmentStateAdapter #

如果你的项目允许升级，Google官方推荐的ViewPager2已经彻底解决了这个老Bug。FragmentStateAdapter的数据集更新逻辑更完善，默认就能正确处理Fragment的复用和更新，不需要你再去重写getItemPosition()做复杂判断。而且ViewPager2还支持垂直滚动、RTL布局等新特性，迁移成本也不高，长远来看是最省心的方案。

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