如何在ViewPager2中动态添加Fragment？解决Fragment already added报错

这是ViewPager2搭配FragmentStateAdapter动态增删条目时的典型问题，核心原因有三个：

1. FragmentStateAdapter默认使用position作为条目的唯一ID，修改数据集后原有条目的position发生变化，Adapter会误认为这些都是新条目，尝试再次添加已经被添加过的Fragment实例，就会抛出Fragment already added异常。
2. 你之前重写getItemId时直接用了Fragment.id，未attach的Fragment默认id是0，所有新Fragment的ID重复，Adapter无法正确识别条目，导致页面空白或报错。
3. 全局调用notifyDataSetChanged()时，Adapter没有感知到局部数据变化，只会复用原有视图，所以新Fragment不会展示。

1. 修改适配器代码，加入稳定唯一ID #

你需要为每个Fragment分配独立且固定的唯一ID，不要依赖position或者Fragment自带的id：

class ViewPagerAdapter(
    private val fragmentList: MutableList<Fragment>,
    fm: FragmentManager,
    lifecycle: Lifecycle,
) : FragmentStateAdapter(fm, lifecycle) {
    // 原子类生成自增唯一ID，保证每个Fragment对应唯一标识
    private val idGenerator = AtomicLong(0)
    // 存储每个Fragment对应的唯一ID
    private val fragmentIds = mutableListOf<Long>().apply {
        repeat(fragmentList.size) { add(idGenerator.getAndIncrement()) }
    }

    override fun getItemCount(): Int = fragmentList.size

    fun addScreen(fragment: Fragment, position: Int) {
        if(!fragmentList.contains(fragment)){
            fragmentList.add(position, fragment)
            fragmentIds.add(position, idGenerator.getAndIncrement())
            // 用局部插入通知，不要用全局notifyDataSetChanged
            notifyItemInserted(position)
        }
    }

    override fun createFragment(position: Int): Fragment {
        return fragmentList[position]
    }

    // 重写两个方法返回稳定ID
    override fun getItemId(position: Int): Long {
        return fragmentIds[position]
    }

    override fun containsItem(itemId: Long): Boolean {
        return fragmentIds.contains(itemId)
    }
}

2. 修复ViewPager所在页面的生命周期问题 #

你之前给适配器传的是Fragment本身的lifecycle，且初始化时机不对，会导致视图重建时重复添加Fragment：

@AndroidEntryPoint
class ViewPagerScreen : Fragment() {
    private lateinit var binding: FragmentViewPagerScreenBinding
    private lateinit var adapter: ViewPagerAdapter
    private lateinit var savedViewInstance: View

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        if (!::savedViewInstance.isInitialized) {
            binding = FragmentViewPagerScreenBinding.inflate(inflater, container, false)
            savedViewInstance = binding.root
            binding.viewPager.isSaveEnabled = false
        }
        return savedViewInstance
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 只在第一次创建视图时初始化ViewPager，避免重复初始化
        if (!::adapter.isInitialized) {
            initViewPager()
        }
    }

    fun addNewScreen(){
        adapter.addScreen(NewFragment(), binding.viewPager.currentItem + 1)
    }

    private fun initViewPager() {
        binding.viewPager.offscreenPageLimit = 2
        // 注意这里传viewLifecycleOwner.lifecycle，不是Fragment本身的lifecycle
        adapter = ViewPagerAdapter(
            mutableListOf(FirstScreen(), SecondScreen(), ThirdScreen()),
            this@ViewPagerScreen.childFragmentManager,
            viewLifecycleOwner.lifecycle
        )
        binding.viewPager.adapter = adapter
        binding.viewPager.isUserInputEnabled = false
    }
}

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