过滤后的RecyclerView侧滑删除时卡片位置异常问题

这问题我之前帮好几个开发者排查过，核心原因就是过滤后的列表是原列表的子集，你直接用position索引去操作数据库/原列表，会因为索引不匹配导致删错数据。侧滑动画看起来正常是因为它只针对当前显示的过滤后列表，但背后的数据同步逻辑没跟上。下面给你一步步的解决方案：

1. 永远用数据项的唯一标识操作数据库，别依赖position #

侧滑删除时，不要通过holder.getAdapterPosition()去原列表里找元素，而是直接从过滤后的列表中拿到当前的item对象，用它的唯一ID（比如你的数据类里的id字段）去删除数据库行。这样不管列表有没有被过滤，你操作的都是正确的数据项，和索引无关。

示例代码（假设你的数据类是TodoItem，有todoId字段）：

// 侧滑删除的ItemTouchHelper.Callback实现
@Override
public void onSwiped(@NonNull RecyclerView.ViewHolder holder, int direction) {
    int position = holder.getAdapterPosition();
    // 先判断position是否有效，避免ViewHolder回收导致的异常
    if (position != RecyclerView.NO_POSITION) {
        TodoItem deletedItem = mFilteredItems.get(position);
        // 用item的唯一ID删数据库，而不是position
        mDbHelper.deleteTodoById(deletedItem.getTodoId());
        
        // 同步更新原列表和过滤后的列表
        mOriginalItems.remove(deletedItem);
        mFilteredItems.remove(position);
        // 用notifyItemRemoved保持删除动画
        notifyItemRemoved(position);
    }
}

2. 维护两个数据集：原始列表+过滤后列表 #

你的Adapter里必须同时持有两个列表：

• mOriginalItems：存储从数据库加载的完整原始数据，永远不要直接修改它（除了删除/新增数据时同步）
• mFilteredItems：存储过滤后的子集，Filterable的逻辑只操作这个列表

正确的Filterable实现示例：

@Override
public Filter getFilter() {
    return new Filter() {
        @Override
        protected FilterResults performFiltering(CharSequence constraint) {
            String filterText = constraint.toString().trim().toLowerCase();
            List<TodoItem> filteredList = new ArrayList<>();
            
            if (filterText.isEmpty()) {
                // 过滤条件为空时，直接返回原列表的副本
                filteredList.addAll(mOriginalItems);
            } else {
                // 遍历原列表，筛选符合条件的项
                for (TodoItem item : mOriginalItems) {
                    if (item.getTitle().toLowerCase().contains(filterText)) {
                        filteredList.add(item);
                    }
                }
            }
            
            FilterResults results = new FilterResults();
            results.values = filteredList;
            return results;
        }

        @Override
        protected void publishResults(CharSequence constraint, FilterResults results) {
            // 更新过滤后的列表并通知UI刷新
            mFilteredItems = (List<TodoItem>) results.values;
            notifyDataSetChanged();
        }
    };
}

3. 删除数据时同步更新两个列表 #

删除操作完成后，必须同时更新mOriginalItems和mFilteredItems：

• 不更新mOriginalItems的话，下次执行过滤时，已经删除的项会重新出现在列表里
• 不更新mFilteredItems的话，RecyclerView的UI会出现位置错乱
• 优先用notifyItemRemoved(position)而不是notifyDataSetChanged()，这样能保留侧滑删除的动画效果

4. 额外注意：避免无效position导致的崩溃 #

侧滑时先判断holder.getAdapterPosition()是否等于RecyclerView.NO_POSITION——如果用户快速滑动或者列表正在刷新，ViewHolder可能已经被回收，此时position是无效的，直接跳过操作即可。

总结一下 #

核心思路就是摆脱对列表索引的依赖，用数据项自身的唯一标识来操作数据库，同时严格维护原始列表和过滤列表的同步。这样不管列表有没有被过滤，侧滑删除的都是正确的数据，UI也不会出现位置异常的问题。

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