Android SQLite插入与查询异常：查询返回空游标无数据

嘿，我明白你现在的困惑——明明插入和查询都没报运行时错误，却查不到任何记录，只能拿到列名，这种“静默失败”的问题确实让人挠头。结合你提供的代码片段（虽然没写完），我帮你从插入和查询两个环节逐一排查常见的坑：

一、先排查插入环节的问题 #

• 是否正确获取了可写数据库实例？
  如果你只是实例化了SQLHelper，但没调用getWritableDatabase()就执行插入，数据根本不会写入数据库。比如错误写法：

  SQLHelper helper = new SQLHelper(context);
  helper.insert(...); // 直接调用自定义插入方法，但没拿到db实例
  

  正确做法是先获取数据库对象：

  SQLiteDatabase db = helper.getWritableDatabase();
  long insertResult = db.insert(TABLE_NAME, null, contentValues);
  db.close(); // 或者用try-with-resources自动关闭
  

  可以打印insertResult的值：返回正数代表插入成功（行ID），返回-1说明插入失败（只是没抛异常）。

• 表名/列名是否完全匹配？
  SQLite默认大小写不敏感，但如果你的CREATE TABLE语句里的表名是user_info，插入时却写成userinfo，SQLite会默默创建一个新表（不会报错），数据全写到了这个不存在的“幽灵表”里，自然查不到。

• 是否手动开启事务但未提交？
  如果用了事务却漏了提交步骤，数据会被回滚：

  db.beginTransaction();
  try {
      db.insert(...);
      // 漏了这句！事务会自动回滚
      // db.setTransactionSuccessful();
  } finally {
      db.endTransaction();
  }
  

• SQLHelper的onCreate()是否正确执行？
  如果数据库已经存在（比如你之前运行过APP），修改onCreate()里的表结构不会生效，除非你升级数据库版本或者删除旧数据库。可以检查onCreate()里的建表语句是否有语法错误，比如漏写逗号、主键定义错误等。

二、再排查查询环节的问题 #

• 是否查错了表/列？
  和插入环节的坑一致，查询时表名或列名写错，会返回一个结构正确但无数据的游标（因为SQLite允许查询不存在的表？不，其实如果表不存在会报错，但如果是你之前创建过旧表，现在查的是旧表结构，就可能出现有列名无数据的情况）。

• 是否忘记移动游标到第一条记录？
  游标默认指向-1位置（第一条记录之前），直接取值会报错或拿到空值，必须先移动游标：

  Cursor cursor = db.query(TABLE_NAME, null, null, null, null, null, null);
  // 错误：直接cursor.getString(0);
  // 正确：
  if (cursor.moveToFirst()) {
      do {
          String value = cursor.getString(cursor.getColumnIndex(COLUMN_NAME));
          // 处理数据
      } while (cursor.moveToNext());
  }
  cursor.close();
  

• 查询条件是否逻辑错误？
  如果你加了WHERE条件，比如"age > ?"但绑定的参数是100，而插入的数据年龄都小于100，自然查不到数据。可以先去掉查询条件，直接查询全表，验证是否有数据。

三、终极排查技巧 #

把设备里的MyDb.db文件导出来（路径一般是/data/data/你的应用包名/databases/MyDb.db），用SQLiteStudio这类可视化工具打开，直接查看表中是否有数据：

• 如果有数据：问题肯定在查询环节
• 如果没有数据：问题在插入环节

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