Android SQLite报错no such table: kids 问题排查修复

核心问题定位 #

这类崩溃几乎都是预置数据库复制逻辑和SQLiteOpenHelper默认生命周期冲突导致的，和查询语句本身没有关系。

高频踩坑点 #

• 复制时机错误：第一次调用getReadableDatabase()/getWritableDatabase()时，SQLiteOpenHelper如果检测到目标路径无库文件，会直接创建空库并回调onCreate。如果把assets库复制逻辑写在onCreate里，此时空库已经创建完成，后续复制要么因为文件被占用写入失败，要么当前数据库连接仍指向空库，查询自然找不到表。
• 存储路径不匹配：复制数据库时硬编码存储路径，没有通过context.getDatabasePath(DB_NAME)获取SQLiteOpenHelper实际读取的官方路径，导致预置库被复制到其他目录，Helper实际读取的是自己创建的空库。
• 文件复制损坏：复制过程中没有正确关闭文件流、未执行flush操作，写入的数据库文件不完整，SQLite无法识别内部表结构。
• 版本逻辑缺失：应用覆盖安装后数据库版本号升高触发onUpgrade回调，默认逻辑删除了旧库重建空库，但没有重新复制assets中对应新版本的预置库。

排查步骤 #

1. 崩溃触发时打日志打印当前查询连接对应的数据库文件绝对路径，把该文件从设备pull到本地，用桌面SQLite客户端打开检查：
   • 如果文件大小远小于assets中的预置库、内部无kids表，说明Helper抢先创建了空库，复制逻辑未生效
   • 如果文件内确实存在kids表，检查表名是否带不可见空格、建表时是否加了严格大小写的引号导致表名匹配失败
2. 检查复制逻辑执行时机：确认复制操作在调用任何会触发SQLiteOpenHelper初始化的方法之前完成，不要把复制逻辑写在onCreate回调里
3. 校验复制完整性：复制完成后对比目标文件和assets源文件的大小，确认完全一致再开放数据库查询操作

可直接复用的修复实现（Kotlin） #

核心逻辑是在Helper初始化前先完成库存在性、版本校验，需要复制时先删除可能存在的空库，复制完成后再走正常的Helper初始化流程：

class DatabaseHelper private constructor(private val context: Context) :
    SQLiteOpenHelper(context, DB_NAME, null, DB_VERSION) {

    companion object {
        private const val DB_NAME = "your_preset_db.db"
        private const val DB_VERSION = 1

        @Volatile
        private var instance: DatabaseHelper? = null

        fun getInstance(context: Context): DatabaseHelper {
            return instance ?: synchronized(this) {
                instance ?: DatabaseHelper(context.applicationContext).also {
                    // 初始化第一步先检查并复制预置库
                    it.copyPresetDBIfNeeded()
                    instance = it
                }
            }
        }
    }

    private fun copyPresetDBIfNeeded() {
        val targetDbFile = context.getDatabasePath(DB_NAME)
        // 已存在且版本匹配则跳过复制
        if (targetDbFile.exists() && getCurrentDbVersion(targetDbFile) == DB_VERSION) return

        // 先删除旧的空库、损坏库、低版本库
        if (targetDbFile.exists()) targetDbFile.delete()
        // 确保数据库目录存在
        targetDbFile.parentFile?.mkdirs()

        // 从assets复制预置库，use扩展会自动关闭流
        context.assets.open(DB_NAME).use { inputStream ->
            FileOutputStream(targetDbFile).use { outputStream ->
                inputStream.copyTo(outputStream)
                outputStream.flush()
            }
        }
    }

    private fun getCurrentDbVersion(dbFile: File): Int {
        // 读取已有库的版本号做校验
        return SQLiteDatabase.openDatabase(
            dbFile.absolutePath,
            null,
            SQLiteDatabase.OPEN_READONLY
        ).use { it.version }
    }

    override fun onCreate(db: SQLiteDatabase?) {
        // 用预置库不需要手写建表逻辑，留空即可
    }

    override fun onUpgrade(db: SQLiteDatabase?, oldVersion: Int, newVersion: Int) {
        // 升级时重新复制对应版本的预置库，需要保留用户数据的话自行加迁移逻辑
        copyPresetDBIfNeeded()
    }

    // 对外提供的kids表查询方法
    fun getVideoListById(kidId: Int): List<Video> {
        val db = readableDatabase
        // 用占位符传参避免SQL注入和类型错误
        val cursor = db.rawQuery(
            "SELECT * FROM kids WHERE id = ?",
            arrayOf(kidId.toString())
        )
        val result = mutableListOf<Video>()
        cursor.use {
            while (it.moveToNext()) {
                // 自行补全cursor解析为Video对象的逻辑
            }
        }
        return result
    }
}

额外注意事项 #

• assets中存放的预置数据库只保留.db主文件即可，不要附带导出时生成的-wal、-shm临时日志文件，避免不同Android版本SQLite兼容问题
• 全局只使用getInstance()获取Helper单例，避免重复打开数据库连接导致的文件锁冲突
• 不要在主线程执行数据库查询操作，避免ANR

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