踩坑记录：RecyclerView 局部刷新notifyItemChanged多次调用只触发一次 onBindViewHolder 的原因-CSDN博客

本文链接：https://blog.csdn.net/csdndfg2/article/details/148191989

1. 问题背景

在做项目的时候，RecyclerView需要使用局部刷新，使用 notifyItemChanged(position, payload) 实现局部刷新，但发现调用多次只执行了一次，第二个刷新不生效。

2. 错误示例（只处理 payloads.get(0)）

@Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position, List<Object> payloads) {
        Log.d(TAG, "onBindViewHolder() 执行局部刷新 position：" + position + " payloads==null：" + (payloads == null));
        if (payloads != null) {
            Log.d(TAG, "payloads大小：" + payloads.size());
        }
        Object payload = payloads.get(0); // 错误：只处理了一个 payload
        if (payloads != null && !payloads.isEmpty()) {
            // 局部刷新操作
        }else{
            // 如果 payload 无效，或者是全量刷新，就执行完整绑定逻辑
            onBindViewHolder(holder, position);
        }
}

3.根本原因分析

去百度查阅资料和咨询AI，RecyclerView 内部会将短时间内同一个 item 的多次 notifyItemChanged(position, payload) 合并，组成一个 payload 列表。所以 payloads 是一个 list，不是单个对象。

当我发送多次notifyItemChanged(position, payload)，然后只执行一次。后面我打印方法参数List<Object> payloads日志才发现，payloads大小有很多个，所以需要循环使用才行。

4. 正确处理方式 —— 遍历 payloads 列表

@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position, List<Object> payloads) {
    Log.d(TAG, "onBindViewHolder() 执行局部刷新 position：" + position + " payloads==null：" + (payloads == null));
    if (payloads != null) {
        Log.d(TAG, "payloads大小：" + payloads.size());
    }
    // Object payload = payloads.get(0); // 错误：只处理了一个 payload
    if (payloads != null && !payloads.isEmpty()) {
        // 局部刷新操作
        for (int i = 0 ; i <payloads.size();i++){
            if ("局部刷新UI字段".equals(payloads.get(i))) {
                // UI更新...
            }
        }
        
    }else{
        // 如果 payload 无效，或者是全量刷新，就执行完整绑定逻辑
        onBindViewHolder(holder, position);
    }
}