RecyclerView单列表项时onCreateViewHolder重复调用问题排查

核心原因分析 #

1. DiffUtil回调逻辑错误 #

你的PayComponentDiffUtil实现完全不符合DiffUtil的设计逻辑：

• areItemsTheSame始终返回true：这个方法的作用是判断新旧列表中的条目是否为同一个实体（比如通过唯一ID区分），但你不管实际条目内容是否相同都返回true。比如首次更新时，旧列表是Banner1，新列表是Banner2，明明是两个不同条目，却被判定为同一个，导致DiffUtil无法正确识别条目替换操作。
• areContentsTheSame始终返回false：这个方法用来判断同一个条目内容是否变更，你强制返回false会让所有更新都被判定为内容变更，但结合上面的错误判断，会导致RecyclerView的更新逻辑混乱，最终触发不必要的ViewHolder重建。

2. 初始数据集与首次更新的冲突 #

Adapter初始化时默认添加了一个Banner1的条目，首次调用update时直接替换成Banner2的条目。结合错误的DiffUtil判断，RecyclerView无法区分这是「条目替换」还是「同一条目内容变更」，进而错误地销毁旧ViewHolder并创建新的。

解决方法 #

1. 修复DiffUtil回调的逻辑 #

给Item类添加合理的判断逻辑，确保areItemsTheSame和areContentsTheSame能正确反映条目状态：

internal class PayComponentDiffUtil(
    private val oldList: List<Item>, private val newList: List<Item>
) : DiffUtil.Callback() {
    override fun getOldListSize() = oldList.size
    override fun getNewListSize() = newList.size

    // 基于条目的唯一标识判断是否为同一个实体（这里用title作为示例，实际建议用唯一ID）
    override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
        return oldList[oldItemPosition].title == newList[newItemPosition].title
    }

    // 比较条目所有内容是否一致
    override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
        val oldItem = oldList[oldItemPosition]
        val newItem = newList[newItemPosition]
        return oldItem.title == newItem.title && oldItem.subtitle == newItem.subtitle
    }
}

2. 调整Adapter初始数据集 #

如果业务上不需要默认的初始条目，将items初始化为空列表，避免首次更新时的不必要条目替换：

internal class MyAdapter : RecyclerView.Adapter<SpotlightViewHolder>() {
    // 初始化为空列表
    private val items = mutableListOf<Item>()

    // 其余代码不变
}

3. 验证更新逻辑 #

确保applyDataSetChanged方法的执行顺序正确：先基于旧数据集计算Diff，再更新数据集，最后分发更新事件（你的现有代码顺序是正确的，无需修改）。

额外说明 #

当DiffUtil正确识别更新类型后，RecyclerView会针对「同一条目内容变更」仅触发onBindViewHolder，不会重建ViewHolder；只有当条目被新增/移除时，才会调用onCreateViewHolder。

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