ViewPager2设置currentItem与FragmentStateAdapter的createFragment位置不匹配问题

问题场景 #

在Kotlin中使用ViewPager2和FragmentStateAdapter时，初始化时设置currentItem=1（默认启动第2页），发现createFragment(position: Int)方法打印的position为0，但ViewPager2正确显示了第2页，导致Fragment加载错误数据。

核心原因 #

ViewPager2默认开启预加载机制，会预加载当前页左右各1个页面。设置currentItem=1时，它会先创建position=0的Fragment（预加载），再创建position=1的Fragment（当前页）。你看到的position=0日志是预加载请求，当前页的Fragment实际上是用正确的position=1创建的，只是日志顺序容易造成误解。

解决方案 #

1. 让适配器准确管理条目ID #

重写getItemId和containsItem方法，避免因position变化导致的Fragment复用错误：

class MyFragmentStateAdapter(private val model: Model, fragment: Fragment) : FragmentStateAdapter(fragment) {
    override fun getItemCount(): Int {
        return model.listItems.size
    }

    // 用数据的唯一标识作为条目ID，确保每个位置对应唯一Fragment
    override fun getItemId(position: Int): Long {
        return model.listItems[position].dataA.hashCode().toLong()
    }

    override fun containsItem(itemId: Long): Boolean {
        return model.listItems.any { it.dataA.hashCode().toLong() == itemId }
    }

    override fun createFragment(position: Int): Fragment {
        val item = model.listItems[position]
        Log.d("LogNameHere", "createFragment called with position: $position")
        return MyFragment.createInstance(position, item.dataA)
    }
}

2. 确保Fragment正确接收参数 #

Fragment必须通过arguments获取传递的position和数据，不依赖外部状态：

class MyFragment : Fragment() {
    private var position: Int = 0
    private var dataA: String = ""

    companion object {
        private const val ARG_POSITION = "arg_position"
        private const val ARG_DATA_A = "arg_data_a"

        fun createInstance(position: Int, dataA: String): MyFragment {
            return MyFragment().apply {
                arguments = Bundle().apply {
                    putInt(ARG_POSITION, position)
                    putString(ARG_DATA_A, dataA)
                }
            }
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        arguments?.let {
            position = it.getInt(ARG_POSITION)
            dataA = it.getString(ARG_DATA_A).orEmpty()
        }
        Log.d("MyFragment", "Loaded position $position with data: $dataA")
    }

    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        val view = inflater.inflate(R.layout.fragment_my, container, false)
        // 用传递的数据更新UI
        view.findViewById<TextView>(R.id.tv_data).text = dataA
        return view
    }
}

3. 可选：关闭预加载（不推荐） #

如果不需要预加载，可以设置offscreenPageLimit=0，但会导致页面切换时重新创建Fragment，影响流畅度：

binding.myViewPager2.apply {
    adapter = MyFragmentStateAdapter(it, this@MyFragment)
    offscreenPageLimit = 0 // 关闭预加载
    currentItem = 1
}

验证方法 #

查看日志会发现两次createFragment调用：一次是position=0（预加载），一次是position=1（当前页）。同时MyFragment的日志会显示当前页的position和对应数据，确认数据正确即可。

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