自定义JdbcSqliteDriver路径时实例创建失败及外键约束问题求助

一、Koin创建AppDatabase单例失败问题 #

你当前的DatabaseDriverFactory中定义了databasePath但并未实际使用，而是硬编码了url = "jdbc:sqlite:test.db"，这会导致数据库文件创建在当前工作目录（可能不是你预期的临时目录），甚至可能因权限问题无法创建/写入文件，进而导致Koin无法初始化数据库实例。

修复步骤： #

1. 使用生成的databasePath构造JDBC URL：

actual class DatabaseDriverFactory {
    actual fun createDriver(): SqlDriver {
        val databasePath = File(System.getProperty("java.io.tmpdir"), "${DatabaseHelper.DATABASE_NAME}.db")
        println("Database path: ${databasePath.absolutePath}")
        // 使用绝对路径构造JDBC URL
        val driver = JdbcSqliteDriver(
            url = "jdbc:sqlite:${databasePath.absolutePath}",
            properties = Properties().apply { put("foreign_keys", "true") }
        ).also {
            // 仅当数据库不存在时创建Schema，避免重复创建导致错误
            if (!databasePath.exists()) {
                AppDatabase.Schema.create(it)
            }
        }
        return driver
    }
}

2. 补全Koin模块依赖：确保SqlDriver实例已被正确注入到容器中，因为createDatabase(driver = get())依赖该实例。如果DatabaseDriverFactory未被声明为Koin单例，需补充：

val databaseModule = module {
    single<SqlDriver> { DatabaseDriverFactory().createDriver() } // 新增这行
    single {
        createDatabase(driver = get())
    }
    single<ITeamDao> { TeamDao() }
}

二、外键约束失败问题 #

SQLITE_CONSTRAINT_FOREIGNKEY错误通常由以下原因导致，逐一排查：

1. 确认外键约束已正确启用 #

虽然你在Driver配置中添加了foreign_keys=true，但需验证是否生效。可以在创建Driver后执行查询确认：

driver.execute(null, "PRAGMA foreign_keys = ON;", 0)
// 或者查询当前状态
val cursor = driver.executeQuery(null, "PRAGMA foreign_keys;", 0)
if (cursor.next()) {
    println("Foreign keys enabled: ${cursor.getLong(0)}") // 输出1表示启用
}
cursor.close()

2. 检查表创建顺序 #

SqlDelight的Schema.create()理论上会按依赖顺序创建表（父表优先），但如果Schema定义存在循环依赖或顺序错误，可能导致子表先于父表创建，触发约束失败。可以手动指定表创建顺序：

// 替换AppDatabase.Schema.create(it)为手动按顺序创建
ParentTable.Schema.create(it)
ChildTable.Schema.create(it)
// 其他表按依赖顺序依次创建

3. 数据插入顺序错误 #

插入数据时必须先插入父表数据，再插入子表数据（子表的外键字段需要对应父表已存在的记录）。例如，如果Team是父表，Player是子表（依赖team_id），需先插入Team记录，再插入Player记录。

4. 检查外键字段类型匹配 #

确保子表的外键字段类型与父表的主键字段类型完全一致（例如都是INTEGER），类型不匹配也会触发约束失败。

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