使用RecyclerView与DiffUtils删除列表项时的异常问题排查

核心问题分析 #

你遇到的问题本质是列表项的位置索引未正确同步，主要由以下三类常见原因导致：

1. 直接使用onBindViewHolder的静态position参数 #

onBindViewHolder中的position是布局绑定时刻的静态位置，当列表通过DiffUtils更新后，该值不会自动刷新。若删除操作依赖这个旧位置，必然出现删错项或索引越界的情况。

错误示例：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    holder.deleteBtn.setOnClickListener(v -> {
        // 直接用静态position，后续操作位置完全错误
        dataList.remove(position);
        DiffUtil.calculateDiff(new MyDiffCallback(oldList, dataList)).dispatchUpdatesTo(this);
    });
}

正确写法：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    holder.deleteBtn.setOnClickListener(v -> {
        // 获取实时更新的适配器位置
        int currentPosition = holder.getAdapterPosition();
        if (currentPosition == RecyclerView.NO_POSITION) return; // 过滤无效位置
        dataList.remove(currentPosition);
        DiffUtil.calculateDiff(new MyDiffCallback(oldList, dataList)).dispatchUpdatesTo(this);
    });
}

2. DiffUtils回调逻辑错误 #

如果DiffUtil.ItemCallback的areItemsTheSame方法未使用item唯一标识（如id）判断是否为同一元素，而是用了position，会导致DiffUtils无法正确识别列表项的变化，进而更新错误位置。

错误示例：

public class MyDiffCallback extends DiffUtil.ItemCallback<Item> {
    @Override
    public boolean areItemsTheSame(Item oldItem, Item newItem) {
        // 错误：用position判断，删除后position会整体偏移
        return oldItem.getPosition() == newItem.getPosition();
    }

    @Override
    public boolean areContentsTheSame(Item oldItem, Item newItem) {
        return oldItem.equals(newItem);
    }
}

正确写法：

public class MyDiffCallback extends DiffUtil.ItemCallback<Item> {
    @Override
    public boolean areItemsTheSame(Item oldItem, Item newItem) {
        // 正确：用item的唯一id判断身份
        return oldItem.getId() == newItem.getId();
    }

    @Override
    public boolean areContentsTheSame(Item oldItem, Item newItem) {
        return oldItem.equals(newItem);
    }
}

3. 数据源更新方式错误 #

若更新数据源时未创建新列表实例，而是直接修改原列表，DiffUtils无法对比新旧数据的差异，导致RecyclerView的位置索引彻底混乱。

错误示例：

// 直接修改原列表，DiffUtils无法检测到有效变化
dataList.remove(currentPosition);
DiffUtil.calculateDiff(new MyDiffCallback(dataList, dataList)).dispatchUpdatesTo(this);

正确写法：

// 创建新列表副本，保证新旧数据完全独立
List<Item> newList = new ArrayList<>(dataList);
newList.remove(currentPosition);
DiffUtil.calculateDiff(new MyDiffCallback(dataList, newList)).dispatchUpdatesTo(this);
dataList = newList; // 更新数据源引用

额外注意事项 #

• 执行删除操作前，务必检查getAdapterPosition()是否等于RecyclerView.NO_POSITION，避免因列表复用导致的无效位置操作。
• 每次调用DiffUtil.calculateDiff时，传入的新旧列表必须是独立实例，不能引用同一个对象。

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