使用 Qt 插件和 SQLCipher 实现 SQLite 数据库加密与解密

TravisBytes

已于 2024-12-25 10:35:12 修改

阅读量3k

点赞数 36

分类专栏： QT 文章标签： sqlite qt c++ 数据库

于 2024-09-27 09:06:31 首次发布

本文链接：https://blog.csdn.net/weixin_43925427/article/details/142553364

版权

SQLite 作为一种轻量级的数据库，被广泛应用于各种桌面和移动应用中。然而，SQLite 本身并不支持数据加密，这时 SQLCipher 成为一个理想的解决方案。本文将详细介绍如何在 Qt 项目中集成 SQLCipher，实现 SQLite 数据库的加密与解密，包括创建加密数据库、插入数据以及查询数据的完整流程。

简介

SQLCipher 是一个开源的扩展，提供了透明的 AES-256 加密功能，使得 SQLite 数据库文件的内容能够被加密和解密。通过将 SQLCipher 与 Qt 结合使用，开发者可以轻松地在 Qt 应用中实现数据加密，确保敏感信息的安全性。

前置条件

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

Qt 开发环境：建议使用 Qt 5 或 Qt 6。
SQLCipher 库：需要编译或安装 SQLCipher，并确保其与 Qt 兼容。
C++ 基础知识：了解基本的 C++ 和 Qt 编程。

项目配置

1. 安装 SQLCipher

首先，需要在系统中安装 SQLCipher。可以通过以下方式进行安装：

使用包管理器：
- Windows：建议使用 vcpkg 安装 SQLCipher。
- macOS：
```
brew install sqlcipher
```
- Linux：
```
sudo apt-get install sqlcipher
```
从源代码编译：

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

2. 配置 Qt 项目

创建一个新的 Qt 控制台应用项目，或在现有项目中进行配置。

在项目的 .pro 文件中添加以下内容，以确保链接 SQLCipher 和 Qt SQL 模块：

QT += core sql
CONFIG += console c++11

# 根据实际安装路径配置 SQLCipher 库
INCLUDEPATH += /usr/local/include
LIBS += -L/usr/local/lib -lsqlcipher

注意：请根据您的系统和 SQLCipher 的安装路径调整 INCLUDEPATH 和 LIBS。

代码实现

以下是一个完整的 Qt 控制台应用程序示例，演示如何使用 SQLCipher 创建加密数据库、插入数据以及读取数据。

创建加密数据库并插入数据

#include <QtSql>
#include <QCoreApplication>
#include <QStandardPaths>
#include <QDir>
#include <QFile>
#include <QDebug>

// 定义加密密钥
const QString DB_PASSWORD = "pass";

// 定义数据库文件名
const QString DB_FILENAME = "local.db";

// 定义表名和示例数据
const QString TABLE_NAME = "test";
const QList<QPair<int, QString>> SAMPLE_DATA = {
   
    {
   1, "AAA"},
    {
   2, "BBB"},
    {
   3, "CCC"},
    {
   4, "DDD"},
    {
   5, "EEE"},
    {
   6, "FFF"},
    {
   7, "GGG"}
};

// 函数声明
bool createAndInsertData(const QString &dbPath);
bool readData(const QString &dbPath);

int main(int argc, 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;

    // 检查数据库文件是否存在
    bool dbExists = QFile::exists(dbPath);

    if (!dbExists) {
   
        qDebug() << "数据库不存在，正在创建并插入数据...";
        if (!createAndInsertData(dbPath)) {
   
            qDebug() << "创建数据库或插入数据失败。";
            return -1;
        }
        qDebug() << "数据库创建并成功插入数据。";
    } else {
   
        qDebug() << "数据库已存在，跳过创建步骤。";
    }

    // 读取数据
    qDebug() << "正在读取数据库中的数据...";
    if (!readData(dbPath)) {
   
        qDebug() << "读取数据库数据失败。";
        return -1;
    }

    qDebug() << "数据读取成功。";

    return 0;
}

/**
 * @brief 创建加密数据库并插入数据
 * @param dbPath 数据库文件路径
 * @return 成功返回 true，否则返回 false
 */
bool createAndInsertData(const QString &dbPath)
{
   
    // 添加 SQLITECIPHER 驱动
    QSqlDatabase db = QSqlDatabase::addDatabase