Android Studio中RecyclerView的getFilter无法筛选问题排查

核心问题分析 #

你的筛选逻辑未生效，本质原因是Adapter始终在展示全量数据列表itemsArrayListFull，而非筛选后的itemsArrayList，同时全量列表的初始化方式存在引用传递的隐患，可能导致数据异常。

具体修复步骤 #

1. 修正Adapter的数据源指向 #

将onBindViewHolder和getItemCount中的itemsArrayListFull替换为itemsArrayList，确保UI展示的是筛选后的列表：

修改onBindViewHolder方法：

@Override
public void onBindViewHolder(@NonNull RecyclerViewHolder holder, int position) {
    // 替换为筛选后的列表itemsArrayList
    holder.nameView.setText(itemsArrayList.get(position).getName());
    holder.sizeView.setText(itemsArrayList.get(position).getSizeString());
    holder.imageView.setImageResource(itemsArrayList.get(position).getImage());
    holder.imageView.setTag(itemsArrayList.get(position).getImage());

    holder.imageView.setOnTouchListener(new View.OnTouchListener() {
        @Override
        public boolean onTouch(View view, MotionEvent motionEvent) {
            listener.onItemSelected(holder.imageView);
            return false;
        }
    });
}

修改getItemCount方法：

@Override
public int getItemCount() {
    // 返回筛选后列表的长度
    return itemsArrayList.size();
}

2. 修复全量列表的初始化逻辑 #

构造函数中直接赋值itemsArrayListFull = itemsArrayList会导致与外部列表引用同一对象，后续外部修改会破坏全量数据。需要创建新的ArrayList进行拷贝：

修改Adapter构造函数：

public RecyclerViewAdapter(Context context, ArrayList<RecyclerViewItems> itemsArrayList, SelectItemListener listener) {
    this.context = context;
    // 拷贝传入的列表，避免引用传递导致的数据异常
    this.itemsArrayListFull = new ArrayList<>(itemsArrayList);
    this.itemsArrayList = new ArrayList<>(itemsArrayListFull);
    this.listener = listener;
}

3. 验证数据字段的访问权限 #

检查RecyclerViewItems类的name字段：如果是私有字段，需使用recyclerViewItems.getName().toLowerCase()替代recyclerViewItems.name.toLowerCase()，否则无法正确获取字段值完成筛选。

修复后流程说明 #

1. 搜索文本输入后，SearchView触发onQueryTextChange，调用recyclerViewAdapter.getFilter().filter(userText)
2. performFiltering基于全量列表itemsArrayListFull筛选符合条件的项，返回筛选结果
3. publishResults将筛选结果更新到itemsArrayList，并调用notifyDataSetChanged()通知UI刷新
4. Adapter通过itemsArrayList展示筛选后的内容，完成预期的搜索筛选功能

内容的提问来源于stack exchange，提问作者Joseph Gyeongjae Kim