如何解决ViewPager切换Fragment时的闪烁问题

问题根源 #

你的代码里有几个核心问题导致了Fragment重建和闪烁：

1. FragmentStateAdapter用法错误：你直接把预先创建好的Fragment实例传给适配器，但FragmentStateAdapter的设计逻辑是通过createFragment()来按需创建/复用Fragment，直接传入实例会打破它的生命周期管理机制，导致重建冲突。
2. 重复初始化适配器和Fragment：每次onCreateView()执行时（比如屏幕旋转、Fragment重新附着），你都会创建新的Fragment列表和适配器，旧的Fragment被销毁、新的被重建，必然引发闪烁。
3. FragmentManager选择错误：使用Activity的FragmentManager管理ViewPager的子Fragment，会导致Fragment的生命周期脱离当前ViewPagerFragment的管控，容易出现意外重建。

修复步骤 #

1. 修正ViewPagerAdapter的实现

不要直接传入Fragment实例列表，而是让适配器根据position创建对应的Fragment：

class ViewPagerAdapter(fm: FragmentManager, lifecycle: Lifecycle) : FragmentStateAdapter(fm, lifecycle) {
    override fun getItemCount(): Int = 6 // 对应你的6个Fragment

    override fun createFragment(position: Int): Fragment {
        return when(position) {
            0 -> Question1()
            1 -> Question2()
            2 -> Question3()
            3 -> Question4()
            4 -> Question5()
            5 -> FinFragment()
            else -> throw IllegalArgumentException("Invalid position: $position")
        }
    }
}

2. 避免重复初始化适配器和Fragment

把适配器的初始化移到onCreate()中（只会执行一次），并且使用当前Fragment的子FragmentManager（childFragmentManager），而不是Activity的：

class ViewPagerFragment : Fragment() {
    private lateinit var binding: FragmentViewPagerBinding
    private lateinit var adapter: ViewPagerAdapter
    val args: ViewPagerFragmentArgs by navArgs()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 在这里初始化适配器，避免重复创建
        adapter = ViewPagerAdapter(childFragmentManager, lifecycle)
    }

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        binding = FragmentViewPagerBinding.inflate(inflater, container, false)
        
        val module = args.module
        if (module == "outil") {
            binding.viewPagerFragment.adapter = adapter
            // 设置预加载页数，减少切换时的重建
            binding.viewPagerFragment.offscreenPageLimit = adapter.itemCount - 1
        }

        return binding.root
    }
}

3. 可选：优化Fragment状态保存

如果你的Fragment有需要保留的状态，确保在Fragment中正确实现onSaveInstanceState()，避免重建时状态丢失导致的界面闪烁：

class Question1 : Fragment() {
    private var someState: String? = null

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        outState.putString("some_state", someState)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        savedInstanceState?.let {
            someState = it.getString("some_state")
        }
    }
}

额外说明 #

• offscreenPageLimit设置为适配器总页数减1，可以让ViewPager预加载所有页面，彻底避免切换时的重建和闪烁，但如果页面较多会占用更多内存，根据实际情况调整。
• 使用childFragmentManager能让ViewPager的子Fragment和当前ViewPagerFragment的生命周期绑定，避免Activity层面的管理导致的意外销毁。

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