ListAdapter调用submitList后部分项点击监听器未重新绑定问题

核心问题根源 #

你遇到的情况是因为DiffUtil的局部更新逻辑仅针对你监听的price和isSelected字段触发UI更新，而点击监听器不属于字段绑定逻辑，未操作的可见项不会重新执行onBindViewHolder的完整绑定，导致监听器仍持有旧数据引用。

可行解决方案 #

1. 每次onBindViewHolder都重新绑定点击监听器

不要依赖局部更新的优化跳过监听器绑定，不管是否是局部更新，在onBindViewHolder中每次都重新设置点击事件，直接使用当前位置的最新数据项：

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    val currentItem = getItem(position)
    // 处理price、isSelected等字段的UI绑定（包括局部更新逻辑）
    
    // 每次都重新设置点击监听器，确保拿到最新的currentItem
    holder.itemView.setOnClickListener {
        // 这里直接使用currentItem，是当前列表的最新数据引用
        handleItemClick(currentItem)
    }
}

这种方式最直接，能保证点击事件始终关联最新的数据，不会因为局部更新跳过绑定而出问题。

2. 若在ViewHolder构造时绑定监听器，需同步更新数据引用

如果习惯在ViewHolder构造函数中设置点击监听器，必须在bind方法里每次更新ViewHolder持有的数据引用：

class ItemViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
    private var currentItem: YourDataModel? = null

    init {
        itemView.setOnClickListener {
            currentItem?.let { item ->
                handleItemClick(item)
            }
        }
    }

    fun bind(item: YourDataModel) {
        // 更新ViewHolder持有的数据引用
        currentItem = item
        // 绑定price、isSelected等UI字段
        itemView.tvPrice.text = item.price.toString()
        itemView.cbSelected.isChecked = item.isSelected
    }
}

这种方式需要确保每次bind都同步更新currentItem，避免点击时拿到旧数据。

3. 提交列表时必须传入新实例

调用submitList时，绝对不能提交原列表对象的引用，即使只是修改字段值，也要创建新的列表副本提交：

// 错误示例：修改原列表后提交同一个实例
yourDataList.forEach { it.isSelected = false }
adapter.submitList(yourDataList)

// 正确示例：创建新列表实例提交
val updatedList = yourDataList.map { it.copy(isSelected = false) }
adapter.submitList(updatedList)

ListAdapter会通过列表引用来判断是否需要触发DiffUtil对比，相同引用会导致更新逻辑异常，进而影响监听器的绑定。

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