在含图片与文字的ListView中使用SearchView遇启动异常求助

看起来你在把纯文字ListView的SearchView筛选逻辑迁移到图文ListView时踩了空指针的坑，这种情况在处理带多组件的列表时很常见，我来帮你一步步排查和解决：

首先，先把空指针的根因找出来——你提供的LogCat信息被截断了，一定要看完整的栈追踪，找到Attempt to invoke virtual method 'void ...' on a null object reference后面的具体代码行，比如是Adapter的getView里ImageView的调用为空，还是数据源列表未初始化，这是快速定位问题的关键。

接下来，针对图文ListView的SearchView筛选，我整理了一套标准的实现方案，同时规避空指针风险：

一、核心问题分析 #

空指针通常出现在这几个场景：

• 布局文件中组件ID与代码中findViewById的ID不匹配，导致组件引用为空
• Adapter的数据源（原始列表/筛选后列表）未初始化就被调用
• getView方法中ViewHolder的组件未正确绑定，或者Item数据为空就直接调用属性
• Filter逻辑中未处理null的筛选条件或结果

二、完整实现示例 #

1. 定义图文Item的数据类 #

public class RankingItem {
    private String itemTitle;
    private int itemImageResId;

    public RankingItem(String title, int imageResId) {
        this.itemTitle = title;
        this.itemImageResId = imageResId;
    }

    // Getter方法
    public String getItemTitle() { return itemTitle; }
    public int getItemImageResId() { return itemImageResId; }
}

2. 实现带Filter的图文Adapter（关键！） #

必须实现Filterable接口来处理筛选，同时全程做非空校验：

public class RankingAdapter extends BaseAdapter implements Filterable {
    private Context mContext;
    // 原始完整数据源，筛选时用它做匹配
    private List<RankingItem> mOriginalData;
    // 筛选后显示的数据源
    private List<RankingItem> mFilteredData;
    private ItemFilter mFilter;

    public RankingAdapter(Context context, List<RankingItem> dataList) {
        mContext = context;
        // 初始化时必须给列表赋值，避免空指针
        mOriginalData = new ArrayList<>(dataList);
        mFilteredData = new ArrayList<>(dataList);
    }

    @Override
    public int getCount() {
        return mFilteredData.size();
    }

    @Override
    public RankingItem getItem(int position) {
        return mFilteredData.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext)
                    .inflate(R.layout.list_item_ranking, parent, false);
            holder = new ViewHolder();
            // 绑定组件时检查是否为空，避免布局ID写错导致的空指针
            holder.itemImage = convertView.findViewById(R.id.item_image);
            holder.itemText = convertView.findViewById(R.id.item_title);
            if (holder.itemImage == null || holder.itemText == null) {
                throw new IllegalArgumentException("布局文件中ImageView/TextView的ID错误");
            }
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        RankingItem currentItem = getItem(position);
        // 先检查Item是否为空
        if (currentItem != null) {
            holder.itemText.setText(currentItem.getItemTitle());
            // 检查图片资源ID是否有效，无效则设置默认图
            if (currentItem.getItemImageResId() != 0) {
                holder.itemImage.setImageResource(currentItem.getItemImageResId());
            } else {
                holder.itemImage.setImageResource(R.drawable.default_avatar);
            }
        }
        return convertView;
    }

    static class ViewHolder {
        ImageView itemImage;
        TextView itemText;
    }

    @Override
    public Filter getFilter() {
        if (mFilter == null) {
            mFilter = new ItemFilter();
        }
        return mFilter;
    }

    private class ItemFilter extends Filter {
        @Override
        protected FilterResults performFiltering(CharSequence constraint) {
            FilterResults results = new FilterResults();
            List<RankingItem> tempFilteredList = new ArrayList<>();

            // 处理空的筛选条件
            if (constraint == null || constraint.length() == 0) {
                tempFilteredList.addAll(mOriginalData);
            } else {
                String filterKeyword = constraint.toString().toLowerCase().trim();
                // 遍历原始列表匹配标题
                for (RankingItem item : mOriginalData) {
                    if (item.getItemTitle().toLowerCase().contains(filterKeyword)) {
                        tempFilteredList.add(item);
                    }
                }
            }

            results.values = tempFilteredList;
            results.count = tempFilteredList.size();
            return results;
        }

        @Override
        protected void publishResults(CharSequence constraint, FilterResults results) {
            mFilteredData.clear();
            // 校验筛选结果不为空再添加
            if (results.values != null) {
                mFilteredData.addAll((List<RankingItem>) results.values);
            }
            notifyDataSetChanged();
        }
    }
}

3. Activity中的初始化与绑定 #

public class RankingActividad extends AppCompatActivity {
    private ListView mRankingListView;
    private SearchView mSearchView;
    private RankingAdapter mAdapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_ranking);

        // 初始化组件时做非空校验
        mRankingListView = findViewById(R.id.ranking_list_view);
        mSearchView = findViewById(R.id.ranking_search_view);
        if (mRankingListView == null || mSearchView == null) {
            throw new IllegalArgumentException("布局中ListView/SearchView的ID错误");
        }

        // 准备测试数据
        List<RankingItem> testData = new ArrayList<>();
        testData.add(new RankingItem("数学排名第一", R.drawable.math_top));
        testData.add(new RankingItem("语文排名第二", R.drawable.chinese_second));
        testData.add(new RankingItem("英语排名第三", R.drawable.english_third));

        // 设置Adapter
        mAdapter = new RankingAdapter(this, testData);
        mRankingListView.setAdapter(mAdapter);

        // 绑定SearchView的筛选监听
        mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
            @Override
            public boolean onQueryTextSubmit(String query) {
                mAdapter.getFilter().filter(query);
                return true;
            }

            @Override
            public boolean onQueryTextChange(String newText) {
                mAdapter.getFilter().filter(newText);
                return true;
            }
        });
    }
}

三、快速排查空指针的小技巧 #

1. 把LogCat的完整栈追踪贴出来，直接定位到出错的代码行
2. 检查所有findViewById的返回值，确保布局ID和代码完全一致
3. 初始化数据源时一定要用new ArrayList<>()赋值，避免列表为null
4. 在所有调用对象方法的地方，先做非空判断（比如if (item != null)）

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