如何使用Anko SQLite库打开SQLCipher加密的数据库文件？

我来帮你搞定这个问题！核心原因其实很明确：Anko自带的ManagedSQLiteOpenHelper是基于Android原生SQLite实现的，完全不支持SQLCipher的加密逻辑，所以直接继承它肯定打不开加密数据库。我们需要调整实现思路，基于SQLCipher的类来构建数据库助手，同时保留你想要的单例管理逻辑。

下面是具体的解决步骤和代码示例：

1. 确保引入正确的SQLCipher依赖 #

先在Module级别的build.gradle中添加SQLCipher的依赖（可以用最新稳定版本）：

dependencies {
    implementation 'net.zetetic:android-database-sqlcipher:4.5.4'
    // 如果你还需要Anko的其他功能，继续保留Anko依赖
    implementation 'org.jetbrains.anko:anko-sqlite:0.10.8'
}

2. 重写数据库助手类，基于SQLCipher实现 #

替换你原来继承ManagedSQLiteOpenHelper的代码，改为继承SQLCipher提供的net.sqlcipher.database.SQLiteOpenHelper，同时完善单例和数据库打开逻辑：

import android.content.Context
import net.sqlcipher.database.SQLiteDatabase
import net.sqlcipher.database.SQLiteOpenHelper

class MyDatabaseOpenHelper private constructor(ctx: Context) :
    SQLiteOpenHelper(ctx.applicationContext, "MyDatabase", null, 1) {

    companion object {
        private var instance: MyDatabaseOpenHelper? = null

        @Synchronized
        fun getInstance(ctx: Context): MyDatabaseOpenHelper {
            if (instance == null) {
                // 必须先初始化SQLCipher的native库，这步不能漏！
                SQLiteDatabase.loadLibs(ctx.applicationContext)
                instance = MyDatabaseOpenHelper(ctx.applicationContext)
            }
            return instance!!
        }
    }

    override fun onCreate(db: SQLiteDatabase) {
        // 这里写你的表创建逻辑，和之前一致即可
        db.execSQL("CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY, name TEXT)")
    }

    override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
        // 处理数据库版本升级，比如表结构变更
        if (oldVersion < newVersion) {
            db.execSQL("DROP TABLE IF EXISTS user")
            onCreate(db)
        }
    }

    // 自定义方法，传入密码获取可写数据库
    fun getWritableDb(password: String): SQLiteDatabase {
        return super.getWritableDatabase(password)
    }

    // 自定义方法，传入密码获取可读数据库
    fun getReadableDb(password: String): SQLiteDatabase {
        return super.getReadableDatabase(password)
    }
}

3. 正确使用加密数据库 #

在需要操作数据库的地方，通过单例获取助手，传入密码打开数据库即可：

val dbHelper = MyDatabaseOpenHelper.getInstance(context)
val db = dbHelper.getWritableDb("your-db-password-here")

// 执行数据库操作示例
val cursor = db.rawQuery("SELECT * FROM user", null)
// 处理cursor数据...
cursor.close()
db.close()

几个关键注意点 #

• 必须初始化SQLCipher库：SQLiteDatabase.loadLibs()是启动SQLCipher的前提，否则会出现native库未加载的崩溃。
• 上下文使用：用applicationContext避免内存泄漏，不要直接传入Activity上下文。
• 密码一致性：确保传入的密码和加密数据库时使用的完全一致，包括大小写、特殊字符等。
• 路径匹配：确认数据库文件的存储路径和SQLCipher加密时的路径一致，默认是应用的databases目录。

既然你之前的Java代码能正常打开，按上面的Kotlin实现调整后，应该就能顺利解决问题了——核心就是把Anko的原生SQLite助手替换为SQLCipher的实现，同时正确处理密码传入和库初始化。

内容的提问来源于stack exchange，提问作者Sz-Nika Janos