Android应用读取SQLite联系人时执行Cursor语句崩溃，求解决

嘿，我懂你碰到的麻烦了——在操作SQLite数据库的Cursor时崩溃，这在Android开发里真的是高频踩坑点。结合你给出的代码片段，我来帮你梳理下常见的问题原因和对应的解决办法，顺便给你补全可用的代码示例。

常见的崩溃原因及修复思路 #

1. 在主线程执行数据库操作 #

Android 3.0之后，主线程不允许执行耗时的数据库操作，轻则ANR，重则直接崩溃。这是最常见的原因之一。
修复办法：把数据库查询放到子线程里，比如用AsyncTask、Coroutine或者HandlerThread。

2. Cursor未正确关闭或为空 #

如果Cursor是null，或者使用完后没关闭，会导致内存泄漏或者抛出IllegalStateException。
修复办法：使用try-finally或者API 19+支持的try-with-resources来管理Cursor的生命周期，确保用完就关。

3. CursorAdapter要求的_id字段缺失 #

如果用CursorAdapter（比如SimpleCursorAdapter）绑定ListView，Cursor里必须包含名为_id的列，否则会直接崩溃。很多人会忽略这个要求。
修复办法：创建数据库表时必须定义_id INTEGER PRIMARY KEY AUTOINCREMENT字段，查询时也要把这个字段包含进去。

4. SQL查询语句错误 #

表名、字段名拼写错误，或者SQL语法错误，会抛出SQLException导致崩溃。
修复办法：检查你的SQL语句，最好用query()方法代替直接写SQL字符串，减少语法错误。

完整的修复代码示例 #

我基于你的代码片段补全了完整的可运行版本，解决了上面提到的所有坑：

public class CustomContactsActivity extends AppCompatActivity { 
    ListView listCustomContactsList;
    private CustomContactDBHelper dbHelper;
    private SimpleCursorAdapter cursorAdapter;

    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_custom_contacts); 
        // 注意这里要补全正确的ListView ID
        listCustomContactsList = findViewById(R.id.custom_contacts_list);
        dbHelper = new CustomContactDBHelper(this);

        // 用AsyncTask在子线程执行数据库查询，避免主线程阻塞
        new FetchContactsTask().execute();
    }

    // 子线程执行数据库查询的异步任务
    private class FetchContactsTask extends AsyncTask<Void, Void, Cursor> {
        @Override
        protected Cursor doInBackground(Void... voids) {
            // 这里用query方法构建查询，确保包含_id字段
            return dbHelper.getReadableDatabase().query(
                "contacts", // 你的联系人表名
                new String[]{"_id", "contact_name", "contact_phone"}, // 必须包含_id
                null, // 查询条件，不需要就传null
                null, // 条件参数
                null, // 分组
                null, // 筛选分组
                "contact_name ASC" // 排序规则
            );
        }

        @Override
        protected void onPostExecute(Cursor cursor) {
            super.onPostExecute(cursor);
            // 初始化SimpleCursorAdapter绑定数据到ListView
            cursorAdapter = new SimpleCursorAdapter(
                CustomContactsActivity.this,
                // 用系统自带的双行布局，也可以用你自定义的布局
                android.R.layout.simple_list_item_2,
                cursor,
                // 数据库里的字段名
                new String[]{"contact_name", "contact_phone"},
                // 布局对应的控件ID
                new int[]{android.R.id.text1, android.R.id.text2},
                0
            );
            listCustomContactsList.setAdapter(cursorAdapter);
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 页面销毁时关闭数据库帮助类
        dbHelper.close();
        // 关闭Cursor，避免内存泄漏
        if (cursorAdapter != null && cursorAdapter.getCursor() != null) {
            cursorAdapter.getCursor().close();
        }
    }

    // 自定义SQLiteOpenHelper，负责数据库的创建和升级
    private static class CustomContactDBHelper extends SQLiteOpenHelper {
        private static final String DATABASE_NAME = "custom_contacts.db";
        private static final int DATABASE_VERSION = 1;

        public CustomContactDBHelper(Context context) {
            super(context, DATABASE_NAME, null, DATABASE_VERSION);
        }

        @Override
        public void onCreate(SQLiteDatabase db) {
            // 创建表时必须包含_id字段，这是CursorAdapter的硬性要求
            String createTableSql = "CREATE TABLE contacts (" +
                    "_id INTEGER PRIMARY KEY AUTOINCREMENT," +
                    "contact_name TEXT NOT NULL," +
                    "contact_phone TEXT NOT NULL)";
            db.execSQL(createTableSql);
        }

        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            // 简单的升级逻辑：删除旧表重建，实际项目里要考虑数据迁移
            db.execSQL("DROP TABLE IF EXISTS contacts");
            onCreate(db);
        }
    }
}

额外的排查技巧 #

• 一定要看Logcat的崩溃日志！日志里会明确告诉你是NullPointerException还是SQLException，以及具体的错误位置，这是最快定位问题的方法。
• 可以用Android Studio的Database Inspector工具查看你的SQLite数据库，确认表结构和数据是否正确。

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