Android SQLite绑定ListView出现Cursor列索引-1及空指针报错求解

第一类报错：java.lang.IllegalStateException: Couldn't read row 0, col -1 from CursorWindow #

报错原因 #

• 列名不匹配：查询时使用的列名和SQLite建表时声明的列名存在拼写错误、大小写差异，导致Cursor无法找到对应列，返回索引值为-1，访问时报错。
• 查询未包含目标列：执行query()方法时传入的列名数组中，没有包含后续需要读取的字段，Cursor返回结果中无该列数据。
• 游标位置无效：读取Cursor数据前，未调用moveToFirst()/moveToPosition()等方法将游标移动到有效数据行。

解决方案 #

1. 校验列索引合法性：读取列值前使用getColumnIndexOrThrow()替代普通getColumnIndex()，如果列不存在会直接抛出明确的列不存在异常，快速定位拼写问题：

// 示例：获取name列的索引
int nameColumnIndex = cursor.getColumnIndexOrThrow("name");
String name = cursor.getString(nameColumnIndex);

2. 核对列名一致性：检查SQLiteOpenHelper的onCreate()方法中建表语句的字段名，和查询时传入的列名完全匹配。
3. 读取前校验游标状态：

if (cursor != null && cursor.moveToFirst()) {
    do {
        // 逐行读取数据逻辑
    } while (cursor.moveToNext());
}
// 用完及时关闭游标
if (cursor != null && !cursor.isClosed()) {
    cursor.close();
}

注意：修改android:allowBackup属性和该报错无关联，该属性控制应用备份能力，不影响本地SQLite读写逻辑，无需调整该配置

第二类报错：调用ListView.setAdapter()时抛出NullPointerException #

报错原因 #

• ListView实例未初始化：findViewById()传入的id和布局文件中ListView的id不匹配，返回null，调用方法时触发空指针。
• 初始化顺序错误：在onCreate()方法中还未调用setContentView()加载布局，就提前执行findViewById()获取ListView，此时返回值必然为null。
• Adapter实例未初始化：传入setAdapter()的Adapter对象本身为null，未提前完成实例化。

解决方案 #

1. 确认初始化顺序：onCreate()方法中先执行setContentView()加载布局，再执行findViewById()获取控件实例。
2. 核对id一致性：检查布局文件中ListView的android:id="@+id/xxx"声明，和代码中findViewById(R.id.xxx)的id完全匹配，避免拼写错误。
3. 调用前增加非空校验：

ListView dataListView = findViewById(R.id.data_list);
// 初始化Adapter
MyDataAdapter adapter = new MyDataAdapter(this, dataList);
if (dataListView != null && adapter != null) {
    dataListView.setAdapter(adapter);
}

如果使用自定义Adapter，还需要确认Adapter构造方法中传入的上下文、数据源等参数已正确初始化，避免Adapter内部逻辑触发空指针。

内容的提问来源于stack exchange，提问作者Abikrishna k r