SQL 语句有误或加密设置不当

macOS：

brew installsqlcipher

Linux：

sudoapt-getinstallsqlcipher

从源代码编译：

访问 SQLCipher GitHub 页面，按照说明进行编译。

解决方法：

• 检查表名和字段是否正确。

  前置条件

  在开始之前，请确保您的开发环境满足以下条件：

  • Qt 开发环境：建议使用 Qt 5 或 Qt 6。
  • 使用 qDebug() << QSqlDatabase::drivers();查看可用驱动，确认 SQLITECIPHER是否存在。";}}else{qDebug()<<"执行 PRAGMA cipher_version 失败:"<<query.lastError().text();}// 查询数据QString selectSQL =QString("SELECT id, name FROM %1 ORDER BY id;").arg(TABLE_NAME);if(!query.exec(selectSQL)){qDebug()<<"执行 SELECT 查询失败:"<<query.lastError().text();db.close();QSqlDatabase::removeDatabase("read_connection");returnfalse;}// 读取并输出数据while(query.next()){intid =query.value(0).toInt();QString name =query.value(1).toString();qDebug()<<id <<":"<<name;}db.close();QSqlDatabase::removeDatabase("read_connection");returntrue;}

    完整代码汇总

    将上述两个函数和 main函数合并，即可得到一个完整的示例程序：

    #include<QtSql>#include<QCoreApplication>#include<QStandardPaths>#include<QDir>#include<QFile>#include<QDebug>// 定义加密密钥constQString DB_PASSWORD ="pass";// 定义数据库文件名constQString DB_FILENAME ="local.db";// 定义表名和示例数据constQString TABLE_NAME ="test";constQList<QPair<int,QString>>SAMPLE_DATA ={{1,"AAA"},{2,"BBB"},{3,"CCC"},{4,"DDD"},{5,"EEE"},{6,"FFF"},{7,"GGG"}};// 函数声明boolcreateAndInsertData(constQString &dbPath);boolreadData(constQString &dbPath);intmain(intargc,char*argv[]){QCoreApplication app(argc,argv);// 获取数据库文件路径QString dir =QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);QString dbPath =QDir(dir).absoluteFilePath(DB_FILENAME);qDebug()<<"DB File Path is:"<<dbPath;// 检查数据库文件是否存在booldbExists =QFile::exists(dbPath);if(!dbExists){qDebug()<<"数据库不存在，正在创建并插入数据...";if(!createAndInsertData(dbPath)){qDebug()<<"创建数据库或插入数据失败。

  总结

  在实际应用中，建议进一步优化密码管理机制，避免将密码硬编码在代码中，可以考虑使用更安全的存储方式。

2. 配置 Qt 项目

创建一个新的 Qt 控制台应用项目，或在现有项目中进行配置。数据插入成功。SQLCipher 版本: "4.5.0"1 : "AAA"2 : "BBB"3 : "CCC"4 : "DDD"5 : "EEE"6 : "FFF"7 : "GGG"数据读取成功。";}// 读取数据qDebug()<<"正在读取数据库中的数据...";if(!readData(dbPath)){qDebug()<<"读取数据库数据失败。

• 使用包管理器：

  • Windows：建议使用 vcpkg 安装 SQLCipher。SQL 语句有误或加密设置不当。";db.close();QSqlDatabase::removeDatabase("create_connection");returntrue;}

    读取加密数据库并查询数据

    /** * @brief 读取加密数据库中的数据 * @param dbPath 数据库文件路径 * @return 成功返回 true，否则返回 false */boolreadData(constQString &dbPath){// 添加 SQLITECIPHER 驱动QSqlDatabase db =QSqlDatabase::addDatabase("SQLITECIPHER","create_connection");db.setDatabaseName(dbPath);db.setPassword(DB_PASSWORD);db.setConnectOptions("QSQLITE_USE_CIPHER=aes256cbc;");// 使用 AES-256-CBC 加密if(!db.open()){qDebug()<<"打开数据库失败（读取）:"<<db.lastError().text();QSqlDatabase::removeDatabase("read_connection");returnfalse;}qDebug()<<"数据库已打开，用于读取数据。插入数据以及查询数据的完整流程。";QSqlQuery query(db);// 验证 SQLCipher 版本（可选）if(query.exec("PRAGMA cipher_version;")){if(query.next()){QString cipher_version =query.value(0).toString();qDebug()<<"SQLCipher 版本:"<<cipher_version;}else{qDebug()<<"无法获取 SQLCipher 版本。";return0;}/** * @brief 创建加密数据库并插入数据 * @param dbPath 数据库文件路径 * @return 成功返回 true，否则返回 false */boolcreateAndInsertData(constQString &dbPath){// 添加 SQLITECIPHER 驱动QSqlDatabase db =QSqlDatabase::addDatabase("SQLITECIPHER","create_connection");db.setDatabaseName(dbPath);db.setPassword(DB_PASSWORD);db.setConnectOptions("QSQLITE_USE_CIPHER=aes256cbc;");// 使用 AES-256-CBC 加密if(!db.open()){qDebug()<<"打开数据库失败（创建）:"<<db.lastError().text();QSqlDatabase::removeDatabase("create_connection");returnfalse;}qDebug()<<"数据库已打开，用于创建和插入数据。
    SQLite 作为一种轻量级的数据库，被广泛应用于各种桌面和移动应用中。数据库创建并成功插入数据。

  • 使用 SQL 工具（如 sqlcipher命令行工具）验证数据库内容。插入数据以及读取数据。正在读取数据库中的数据...数据库已打开，用于读取数据。

    参考

    带有加密功能的 SQLite Qt 插件（v1.0）
    QtCipherSqlitePlugin插件使用 (2)
    GitHub - devbean/QtCipherSqlitePlugin