QT开发日志：QT数据库操作：SQLite与MySQL的集成

鸽芷咕

发布于 2025-05-31 13:48:35

33700

代码可运行

文章被收录于专栏：C++干货基地C++干货基地

运行总次数：0

代码可运行

前言

在QT开发过程中，数据库操作是非常重要的一环。本文将详细记录如何在QT中集成SQLite与MySQL数据库，分享开发过程中的经验和遇到的问题及解决方案。

一、环境准备

QT版本：确保你已经安装了合适版本的QT开发环境，本文使用的是QT 5.15。
数据库驱动：
- SQLite：QT默认自带SQLite的驱动，无需额外安装。
- MySQL：需要下载并安装MySQL的驱动。可以从MySQL官方网站下载对应版本的驱动文件，然后将其放置到QT的插件目录下，通常为QT安装目录/plugins/sqldrivers。

二、SQLite集成

（一）连接SQLite数据库

在QT中，使用QSqlDatabase类来管理数据库连接。下面是连接SQLite数据库的代码示例：

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 添加SQLite数据库驱动
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    // 设置数据库名称
    db.setDatabaseName("test.db");

    if (db.open()) {
        qDebug() << "SQLite数据库连接成功！";
    } else {
        qDebug() << "SQLite数据库连接失败：" << db.lastError().text();
    }

    return a.exec();
}

（二）执行SQL语句

连接成功后，就可以执行SQL语句了。例如，创建一个表并插入数据：

#include <QSqlQuery>

QSqlQuery query;
// 创建表
query.exec("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INT)");
// 插入数据
query.prepare("INSERT INTO users (name, age) VALUES (:name, :age)");
query.bindValue(":name", "Alice");
query.bindValue(":age", 25);
if (query.exec()) {
    qDebug() << "数据插入成功！";
} else {
    qDebug() << "数据插入失败：" << query.lastError().text();
}

三、MySQL集成

（一）连接MySQL数据库

连接MySQL数据库的代码与SQLite有一些不同，主要是驱动名称和连接参数的设置：

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 添加MySQL数据库驱动
    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
    // 设置数据库主机名
    db.setHostName("localhost");
    // 设置数据库端口号
    db.setPort(3306);
    // 设置数据库用户名
    db.setUserName("root");
    // 设置数据库密码
    db.setPassword("password");
    // 设置数据库名称
    db.setDatabaseName("testdb");

    if (db.open()) {
        qDebug() << "MySQL数据库连接成功！";
    } else {
        qDebug() << "MySQL数据库连接失败：" << db.lastError().text();
    }

    return a.exec();
}

（二）执行SQL语句

MySQL执行SQL语句的方式与SQLite类似：

#include <QSqlQuery>

QSqlQuery query;
// 创建表
query.exec("CREATE TABLE IF NOT EXISTS products (id INTEGER PRIMARY KEY AUTOINCREMENT, product_name TEXT, price DECIMAL(10, 2))");
// 插入数据
query.prepare("INSERT INTO products (product_name, price) VALUES (:product_name, :price)");
query.bindValue(":product_name", "Widget");
query.bindValue(":price", 19.99);
if (query.exec()) {
    qDebug() << "数据插入成功！";
} else {
    qDebug() << "数据插入失败：" << query.lastError().text();
}

四、遇到的问题及解决方案

MySQL驱动加载失败：如果在运行时提示找不到MySQL驱动，确保驱动文件放置在正确的目录下，并且QT的环境变量配置正确。可以在QT Creator的项目设置中，添加QT += sql来确保SQL模块被正确包含。
字符编码问题：在处理中文字符时，可能会遇到字符编码问题。可以在连接数据库时，设置正确的字符编码，例如db.setConnectOptions("MYSQL_OPT_CHARSET_NAME=utf8");。