恢复实例状态后ViewPager2 Adapter未重置，如何动态更新Fragment？

问题描述 #

我需要配置ViewPager2以动态更新其中显示的Fragment。为此，我在ViewModel中创建了一个包含Fragment所需数据列表的LiveData对象：

val items: LiveData<List<Item>>

在包含ViewPager2的Fragment的onViewCreated方法中，我设置了对该items的观察：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)

    viewModel.items.observe(viewLifecycleOwner) { items ->
        binding.viewPager.adapter = createFragmentStateAdapter(items)
    }
}

正常运行时一切正常，但开启「不保留活动」测试后，应用前后台切换时，包含ViewPager2的Fragment被重建，items可观测对象也触发了更新，然而ViewPager2却显示旧Fragment，忽略了观察块中创建的新Adapter。推测可能是ViewPager2恢复自身状态时忽略了Adapter的最新变更，请问如何让ViewPager2在Adapter变化时正确更新？

解决方案 #

问题核心是ViewPager2重建时会优先恢复自身保存的状态（如当前页面位置），此时新Adapter还未完成初始化，导致旧Fragment被保留。可以通过以下两种方案解决：

方案一：复用Adapter而非每次创建新实例 #

不要在数据更新时重新创建FragmentStateAdapter，而是复用同一个Adapter，通过内部数据更新+通知变更的方式刷新页面：

1. 自定义带数据更新方法的FragmentStateAdapter：

class CustomFragmentStateAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {
    private var itemList: List<Item> = emptyList()

    fun updateItems(newItems: List<Item>) {
        itemList = newItems
        notifyDataSetChanged()
    }

    override fun getItemCount(): Int = itemList.size

    override fun createFragment(position: Int): Fragment {
        // 根据当前位置的Item创建对应Fragment
        return TargetFragment.newInstance(itemList[position])
    }
}

2. 在宿主Fragment中初始化并复用Adapter：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)

    val adapter = CustomFragmentStateAdapter(this)
    binding.viewPager.adapter = adapter

    viewModel.items.observe(viewLifecycleOwner) { items ->
        adapter.updateItems(items)
    }
}

方案二：设置新Adapter后强制清除旧状态 #

如果必须创建新Adapter，可以在设置后强制ViewPager2清除保存的旧状态，确保新Adapter生效：

viewModel.items.observe(viewLifecycleOwner) { items ->
    binding.viewPager.adapter = createFragmentStateAdapter(items)
    // 清除ViewPager2保存的旧状态，让新Adapter接管页面
    binding.viewPager.clearSavedState()
    // 可选：根据业务需求手动恢复页面位置
    binding.viewPager.setCurrentItem(0, false)
}

注意：这种方式会丢失之前的页面位置状态，需要自行处理位置恢复逻辑。

额外优化建议 #

如果你的Item有唯一标识，建议重写FragmentStateAdapter的getItemId和containsItem方法，让ViewPager2更高效地识别页面变化，避免不必要的Fragment重建：

override fun getItemId(position: Int): Long {
    // 返回Item的唯一ID，比如itemList[position].id
    return itemList[position].id.toLong()
}

override fun containsItem(itemId: Long): Boolean {
    return itemList.any { it.id == itemId }
}

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