如何连接SQLCipher 3加密的SQLite数据库？JDBC连接报错排查

核心问题分析 #

你遇到的问题主要是依赖配置不全、SQLCipher API使用错误，以及普通SQLite JDBC不支持加密数据库导致的，以下是针对性解决步骤：

1. 确保依赖完整（关键） #

SQLCipher for Java 不只是需要jar包，还必须搭配对应操作系统的native库文件（Windows是.dll，Linux是.so，Mac是.dylib）：

• 下载SQLCipher压缩包时，要包含libs目录下的native库
• 在Eclipse中配置：右键项目 → Build Path → Configure Build Path → Libraries，找到SQLCipher的jar，展开后点击「Native library location」，设置为存放native库的文件夹路径

2. 修正JDBC连接代码（推荐方式） #

普通SQLite JDBC驱动不支持SQLCipher加密，必须使用SQLCipher官方的JDBC实现，且不能通过URL拼接?key=传递密钥，正确写法是用SQLiteConfig配置密钥：

public class DBmanager {
    Connection connection;
    String database = "jdbc:sqlite:src/database/cryptedDB.db";
    private String encryptionKey = "kilikilikoinkoin";

    public boolean Connect() throws SQLException {
        try {
            // 初始化SQLCipher配置
            SQLiteConfig config = new SQLiteConfig();
            config.setKey(encryptionKey); // 设置加密密钥
            // 传入配置属性建立连接
            connection = DriverManager.getConnection(database, config.toProperties());
            return connection != null && !connection.isClosed();
        } catch (SQLException e) {
            e.printStackTrace();
            return false;
        }
    }
}

3. 直接使用SQLCipher原生API（非JDBC场景） #

如果不用JDBC，直接用SQLCipher的SQLiteDatabase类，需注意游标处理和native库加载：

// 加载SQLCipher native库（必须放在操作数据库前）
SQLiteDatabase.loadLibs();

String databasePath = "src/database/cryptedDB.db";
String passphrase = "kilikilikoinkoin";

// 打开加密数据库
SQLiteDatabase sqLiteDatabase = SQLiteDatabase.openDatabase(
    databasePath, 
    passphrase, 
    null, 
    SQLiteDatabase.OPEN_READWRITE
);

// 执行查询时必须移动游标到第一条记录
Cursor cursor = sqLiteDatabase.rawQuery("SELECT sqlite3_handle_v2('main');", null);
if (cursor.moveToFirst()) {
    long nativeConnectionPtr = cursor.getLong(0);
    // 这里处理获取到的连接指针
}
// 用完游标和数据库要关闭
cursor.close();
sqLiteDatabase.close();

4. 匹配加密版本兼容性 #

确认DB Browser for SQLite加密时选择的是SQLCipher 3版本，Java端必须使用对应版本的SQLCipher驱动（不能用SQLCipher 4.x，因为加密算法格式有差异），否则会出现解密失败。

5. Eclipse构建路径排查 #

如果rawQuery()仍报错：

• 检查SQLCipher的jar是否真的被添加到项目的「Build Path」中（不是只放lib文件夹里）
• 清理项目：Project → Clean，然后重新构建

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