CentOS下Qt如何配置驱动连接MySQL数据库接口？

在 CentOS 系统上构建基于 Qt 框架并连接 MySQL 数据库的应用程序，是一项在服务器后端、嵌入式设备及桌面软件开发中常见的任务，这个组合利用了 CentOS 的稳定性、Qt 的跨平台 GUI 能力以及 MySQL 的成熟数据库管理功能，本文将详细介绍在 CentOS 环境下，如何从零开始配置开发环境、编译 Qt 的 MySQL 驱动，并最终在 Qt 项目中实现与 MySQL 数据库的交互。

环境准备

在开始编码之前,确保系统中已安装所有必需的组件，这些组件构成了开发的基础，任何一个环节的缺失都可能导致后续步骤失败，以下是在 CentOS 7/8 上所需的核心软件包。

组件类别	软件包名称	安装命令	说明
数据库	mariadb-server	sudo yum install mariadb-server	CentOS 默认使用 MariaDB，它与 MySQL 完全兼容。
数据库客户端库	mariadb-devel	sudo yum install mariadb-devel	关键，提供编译 Qt 驱动所需的头文件和链接库。
Qt 开发环境	Qt 官方在线安装器	从 Qt 官网下载并运行	推荐使用在线安装器，可选择所需的 Qt 版本和组件。
编译工具	gcc-c++, make	sudo yum groupinstall "Development Tools"	提供 C++ 编译器和构建工具。

安装完成后,启动并启用 MariaDB 服务：

sudo systemctl start mariadb
sudo systemctl enable mariadb

建议运行 mysql_secure_installation 脚本进行安全初始化设置，如设置 root 密码、移除匿名用户等。

编译 Qt 的 MySQL 驱动

Qt 通过插件模式支持不同的数据库，但官方预编译的 Qt 版本通常不包含 MySQL 驱动，因为其依赖于特定系统的 MySQL 客户端库，我们需要手动编译这个驱动。

1. 定位源码：找到 Qt 安装目录下的 MySQL 驱动源码，路径通常类似于 ~/Qt/5.15.2/Src/qtbase/src/plugins/sqldrivers/mysql。

2. 配置项目：进入该目录，使用 qmake 工程文件进行配置，这一步需要明确指定 MySQL 客户端库的头文件和库文件路径。

   # 进入驱动源码目录
   cd ~/Qt/5.15.2/Src/qtbase/src/plugins/sqldrivers/mysql
   # 使用 qmake 生成 Makefile，请根据你的系统路径调整 INCLUDEPATH 和 LIBS
   qmake "INCLUDEPATH+=/usr/include/mysql" "LIBS+=-L/usr/lib64/mysql -lmysqlclient" mysql.pro

   • INCLUDEPATH+=/usr/include/mysql：告诉编译器去哪里查找 mysql.h 等头文件。
   • LIBS+=-L/usr/lib64/mysql -lmysqlclient：告诉链接器去哪里寻找 libmysqlclient.so 库文件，并链接它。

3. 编译与安装：执行 make 命令进行编译，然后将生成的插件文件复制到 Qt 的插件目录。

   

   # 编译
   make
   # 编译成功后，会在当前目录或子目录下生成 libqsqlmysql.so (或类似名称) 文件
   # 将其复制到 Qt 的 sqldrivers 插件目录
   sudo cp ../../../../plugins/sqldrivers/libqsqlmysql.so ~/Qt/5.15.2/gcc_64/plugins/sqldrivers/

4. 验证驱动：可以编写一个简单的 Qt 程序来验证驱动是否加载成功。

   #include <QCoreApplication>
   #include <QtSql>
   #include <QDebug>
   int main(int argc, char *argv[]) {
       QCoreApplication a(argc, argv);
       qDebug() << "Available drivers:" << QSqlDatabase::drivers();
       return 0;
   }

   如果输出列表中包含 "QMYSQL"，则表示驱动已成功加载。

Qt 项目中的代码实现

环境配置完成后,就可以在 Qt 项目中编写代码来连接和操作 MySQL 数据库了。

1. 配置 .pro 文件：
   在项目的 .pro 文件中，添加 sql 模块，以启用 Qt 的数据库功能。

   QT += core sql

2. 编写连接与查询代码：
   以下是一个完整的示例，展示了如何连接数据库、执行查询并处理结果。

   #include <QSqlDatabase>
   #include <QSqlQuery>
   #include <QSqlError>
   #include <QDebug>
   bool connectToDatabase() {
       QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
       db.setHostName("localhost"); // 数据库服务器地址
       db.setDatabaseName("testdb"); // 要连接的数据库名
       db.setUserName("root");      // 用户名
       db.setPassword("your_password"); // 密码
       if (!db.open()) {
           qDebug() << "Database connection failed:" << db.lastError().text();
           return false;
       }
       qDebug() << "Database connected successfully!";
       return true;
   }
   void queryData() {
       QSqlQuery query;
       if (query.exec("SELECT id, name FROM users")) {
           while (query.next()) {
               int id = query.value(0).toInt();
               QString name = query.value(1).toString();
               qDebug() << "ID:" << id << "Name:" << name;
           }
       } else {
           qDebug() << "Query failed:" << query.lastError().text();
       }
   }
   // 在 main 函数或其他合适位置调用
   // int main(...) {
   //     ...
   //     if (connectToDatabase()) {
   //         queryData();
   //     }
   //     QSqlDatabase::database().close(); // 关闭数据库连接
   //     ...
   // }

   这段代码首先尝试建立一个到 MySQL 服务器的连接，如果成功，则执行一条 SELECT 语句，并遍历输出结果集，错误处理是健壮程序的关键，务必检查 db.open() 和 query.exec() 的返回值，并使用 lastError() 获取详细的错误信息。

---

相关问答 (FAQs)

问题1：我已经通过 Qt 安装器安装了 Qt，为什么在程序中仍然提示 “QMYSQL driver not loaded”？

解答： 这是最常见的问题，Qt 官方提供的二进制安装包为了保持通用性和减小体积，默认不包含针对特定系统（如你的 CentOS 上的 MariaDB）编译的数据库驱动，你需要按照本文 “编译 Qt 的 MySQL 驱动” 章节的步骤，手动下载 Qt 源码，利用系统中已安装的 mariadb-devel 包来编译 libqsqlmysql.so 插件，并将其放置到正确的 plugins/sqldrivers 目录下，Qt 程序在运行时才能找到并加载该驱动。

问题2：除了 QMYSQL，Qt 还支持哪些其他主流数据库的接口？

解答： Qt 的数据库模块（Qt SQL）提供了丰富的数据库驱动，通过统一的接口访问不同的数据库系统，除了 QMYSQL（用于 MySQL 和 MariaDB），常用的还包括：

• QSQLITE：用于访问 SQLite 数据库，这是一个轻量级的、基于文件的数据库，其驱动是内置的，无需额外安装和编译，非常适合小型应用和本地数据存储。
• QPSQL：用于连接 PostgreSQL 数据库，这是一个功能强大的开源对象关系型数据库系统，同样需要手动编译驱动。
• QODBC：通过 ODBC（开放数据库连接）标准，可以连接到几乎所有提供了 ODBC 驱动的数据库，如 Microsoft SQL Server、Oracle 等，在 Linux 上需要安装 unixODBC。
• QOCI：用于连接 Oracle 数据库。

开发者可以根据项目需求选择合适的数据库,而 Qt 代码层面的操作（如 QSqlQuery）基本保持一致，这极大地提高了代码的可移植性。