多模块Android应用中用Hilt提供/注入SQLiteDatabase遇问题

你遇到的核心问题是SQLiteDatabase不能直接实例化或通过自身依赖来提供，它必须通过SQLiteOpenHelper（或Room）来获取实例。下面是具体的解决步骤：

1. 先实现SQLiteOpenHelper #

SQLiteDatabase的构造是私有的，必须通过SQLiteOpenHelper的getWritableDatabase()或getReadableDatabase()方法获取。先写一个自定义的OpenHelper：

class AppDatabaseHelper(context: Context) : SQLiteOpenHelper(context, "app_db", null, 1) {
    override fun onCreate(db: SQLiteDatabase) {
        // 在这里创建你的表结构，比如：
        db.execSQL("CREATE TABLE IF NOT EXISTS tracks (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)")
    }

    override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
        // 处理数据库版本升级逻辑
    }
}

2. 在Hilt模块中提供SQLiteOpenHelper和SQLiteDatabase #

不要直接尝试提供SQLiteDatabase，而是先提供OpenHelper，再通过它获取数据库实例。修改你的Hilt模块：

@Module
@InstallIn(SingletonComponent::class)
object DatabaseModule { // 建议用object避免不必要的实例化

    @Provides
    @Singleton
    fun provideDatabaseHelper(@ApplicationContext context: Context): AppDatabaseHelper {
        return AppDatabaseHelper(context)
    }

    @Provides
    @Singleton
    fun provideSQLiteDatabase(helper: AppDatabaseHelper): SQLiteDatabase {
        return helper.writableDatabase // 或者使用readableDatabase，根据业务需求选择
    }
}

3. 修正仓库类的注入 #

你的TrackRepository可以保持原来的注入方式，现在Hilt能正确提供SQLiteDatabase实例了：

class TrackRepository
@Inject constructor(
    private val database: SQLiteDatabase // 用val更安全，避免可变引用导致的意外问题
) {
    // 你的数据库操作逻辑
}

关于依赖循环的解释 #

你之前遇到的循环依赖，是因为provideDatabase方法的参数要求注入SQLiteDatabase，而这个方法本身又是用来提供SQLiteDatabase的——Dagger无法确定先从哪里获取实例，从而形成循环。改成从SQLiteOpenHelper获取后，依赖链变为Context → AppDatabaseHelper → SQLiteDatabase，循环问题自然解决。

如果后续想简化数据库操作，也可以考虑迁移到Room框架，Hilt对Room的支持更完善，通过@Database注解就能轻松注入RoomDatabase实例。

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