Android自定义Custom Adapter触发NullPointerException问题求助

核心问题定位 #

错误指向Adapter中设置year的代码行，说明该位置存在空对象调用，常见触发场景包括：控件未初始化、实体类字段为空、数据源混入null对象、数据库查询字段异常。以下是针对性排查方案：

1. 检查Adapter中控件初始化是否正确 #

问题场景

若使用ViewHolder模式，year对应的TextView未通过convertView.findViewById正确获取（比如布局id拼写错误、convertView为空时未初始化控件），会导致控件对象为null，调用setText时触发NPE。

错误示例

// 布局文件中id为tv_year，但代码中写成了year_text
holder.yearTv = convertView.findViewById(R.id.year_text);

解决方案

• 核对布局文件中year对应的TextView id，确保与Adapter中findViewById的参数完全一致
• 确保getView方法中ViewHolder的初始化逻辑正确：

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        convertView = LayoutInflater.from(context).inflate(R.layout.song_item_layout, parent, false);
        holder = new ViewHolder();
        // 确保id与布局文件匹配
        holder.yearTv = convertView.findViewById(R.id.tv_year);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }
    // 后续数据设置逻辑
}

2. 对Song实体类year字段做安全处理 #

问题场景

即使做了空值检查，若直接调用song.getYear().toString()或未检查song本身是否为null，仍会触发NPE。

错误示例

// 未检查song或year是否为null
holder.yearTv.setText(song.getYear());

解决方案

添加双重空值校验，为空时设置默认文本：

Song currentSong = songList.get(position);
if (currentSong != null) {
    Integer year = currentSong.getYear();
    holder.yearTv.setText(year != null ? String.valueOf(year) : "未知年份");
} else {
    holder.yearTv.setText("未知年份");
}

3. 过滤数据源中的null对象 #

问题场景

若Adapter的数据源（如List<Song>）中混入null的Song对象，在getView中调用其方法时会触发NPE。

解决方案

在填充数据源时过滤null元素：

// 从数据库查询后处理数据源
List<Song> rawSongList = dbHelper.getAllSongs();
List<Song> validSongList = new ArrayList<>();
for (Song song : rawSongList) {
    if (song != null) {
        validSongList.add(song);
    }
}
// 用过滤后的列表初始化Adapter
customAdapter = new CustomAdapter(this, validSongList);

4. 检查数据库查询的year字段逻辑 #

问题场景

DBHelper查询时，若Cursor中year字段的索引获取错误（比如字段名拼写错误），或未处理字段为空的情况，会导致Song对象的year字段为null。

错误示例

// 数据库表字段名为year，但代码中写成了years
int yearIndex = cursor.getColumnIndex("years");
song.setYear(cursor.getInt(yearIndex));

解决方案

• 核对数据库表的year字段名，确保与getColumnIndex的参数一致
• 处理字段为空的情况：

int yearIndex = cursor.getColumnIndex("year");
if (yearIndex != -1 && !cursor.isNull(yearIndex)) {
    song.setYear(cursor.getInt(yearIndex));
} else {
    song.setYear(null); // 或设置默认值0
}

验证步骤 #

1. 在Adapter设置year的代码行添加断点，运行APP后查看holder.yearTv、currentSong、currentSong.getYear()是否为null
2. 交叉核对布局文件id、数据库字段名与代码中的对应关系
3. 检查数据源填充逻辑，确认无null对象混入

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