自定义ItemCount的ViewPager(RecyclerView)数据更新异常排查

问题背景 #

基于ListAdapter（搭配DiffUtil.ItemCallback）实现RecyclerView适配器，支持多itemViewType。当API返回循环标记且数据集长度>1时，重写getItemCount()返回1000实现滚动循环效果。

切换应用Locale后Fragment重建，数据通过Rx异步多次加载（无法改为同步），切换后数据集会短暂混合多语言，最终通过LiveData提交完全正确的翻译数据集（ID包含正确Locale标签）。但出现以下问题：

• 最后一次数据更新后，当前显示及附近的部分视图未完成翻译
• 视图被回收后重新显示则正常
• DiffUtil计算结果正确（曾强制ItemCallback始终返回false，问题依旧）
• 关闭循环模式（itemCount等于实际数据集长度）时无此问题

已尝试无效方案：

• 不使用RecyclerView默认itemView
• 强制DiffUtil始终返回false
• 为数据项ID添加Locale标签
• 切换Locale前提交空数据集
• 为Rx添加防抖

更新：手动调用adapter.notifyDatasetChanged()可解决问题，现疑问转为：为何ListAdapter在此场景下无法正确分发通知回调？

问题原因分析 #

ListAdapter核心是通过DiffUtil计算差异后，精准分发局部更新通知（如notifyItemChanged/notifyItemRangeChanged）。但循环模式下getItemCount()返回的1000远大于实际数据集长度，导致ListAdapter内部逻辑与RecyclerView显示的视图位置出现映射错位：

1. 循环模式下实际通过getItem(position % realDataSize)获取数据，但ListAdapter的DiffUtil计算基于CurrentList的真实索引，而非RecyclerView显示的position
2. Locale切换后多次异步更新数据时，ListAdapter针对真实数据集索引生成的更新通知，无法匹配RecyclerView中经过模运算的显示position，导致部分视图未收到更新指令
3. 手动调用notifyDatasetChanged()会强制刷新所有视图，跳过DiffUtil的局部更新逻辑，因此能覆盖所有显示的视图

解决方案 #

方案1：修正循环模式下的DiffUtil匹配逻辑 #

重写getItemId(int position)方法，让每个显示的position对应唯一的真实数据ID；同时在DiffUtil.ItemCallback中基于数据ID（含Locale标识）判断是否有变化：

override fun getItemId(position: Int): Long {
    val realPosition = position % currentList.size
    return currentList[realPosition].id // ID需包含Locale标识
}

// 对应的ItemCallback实现
object ItemCallback : DiffUtil.ItemCallback<DataItem>() {
    override fun areItemsTheSame(oldItem: DataItem, newItem: DataItem): Boolean {
        return oldItem.id == newItem.id // 语言变化时ID不同，判定为不同item
    }

    override fun areContentsTheSame(oldItem: DataItem, newItem: DataItem): Boolean {
        return oldItem.content == newItem.content
    }
}

方案2：循环模式下强制全量更新 #

在LiveData观察者中添加判断，当检测到Locale切换且处于循环模式时，提交数据后手动触发全量更新：

liveData.observe(viewLifecycleOwner) { newData ->
    if (isLoopModeEnabled && localeChangedFlag) {
        adapter.submitList(newData) {
            adapter.notifyDataSetChanged()
        }
        localeChangedFlag = false
    } else {
        adapter.submitList(newData)
    }
}

方案3：优化循环模式实现方式 #

放弃重写getItemCount()的方式，改用自定义LayoutManager实现循环效果（如重写LinearLayoutManager的scrollHorizontallyBy/scrollVerticallyBy方法），让getItemCount()保持真实数据集长度，确保ListAdapter的DiffUtil逻辑正常运行。

总结 #

循环模式下重写getItemCount()会破坏ListAdapter的索引映射逻辑，导致局部更新通知无法匹配RecyclerView的显示位置。手动全量更新是最直接的临时解决方案，长期来看推荐优化循环实现方式，让ListAdapter的DiffUtil逻辑正常工作。

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