当前位置：首页 > news >正文

Qt 连接 MySql 数据库

news 2026/5/12 1:16:26

摘要：由于Qt6.x版本的源码工程存在qmake和cmake混用的情况，本文主要讲述如何在Qt 源码为 cmake工程的情况下，如何编译Mysql驱动插件并且连接MySql数据库的方式。

如果源码是qmake工程，可以参考这篇教程

前言

在 Qt 6.x 版本使用 QSqlDatabase 去连接 MySQL 数据库的时候会出现失败的问题，经过检查发现是缺少 MySql 驱动的问题。这里用 Qt 6.9.3 版本进行演示

用如下代码可以检查：

    QStringList drivers = QSqlDatabase::drivers();for (QString driver : drivers) {qDebug() << driver;}

打印的结果显示，缺少MySql的驱动。

通过查阅资料得知，Qt内部会将所有的数据库驱动封装为 QSqlDriverPlugin 插件，Qt 通过加载插件来完成驱动程序的加载。

驱动程序存放目录： Qt\6.9.3\mingw_64\plugins\sqldrivers

打开目录可以看到，确实没有 MySql 的驱动库。通过翻阅资料得知，Qt提供了MySql插件的代码，但是需要自己去编译链接。那么整体的大致流程如下：下载Qt源码->找到MySql插件->编译->拷贝到插件目录(Qt\6.9.3\mingw_64\plugins\sqldrivers)

工程修改

找到 Qt 源码中数据库插件目录： Qt\6.9.3\Src\qtbase\src\plugins\sqldrivers ，在这个目录当中存放的就是驱动的源码

使用 vscode 或者 qtcreater打开这个目录，一定要打开这个目录，因为Qt的一些 cmake 自定义函数是在这个CMakeList中引入的，可以理解为这个CMakeList就是最小构建单元。

打开后，找到添加 mysql 的分支判断，直接强制添加MySQL分支。

if(QT_FEATURE_sql_mysql)add_subdirectory(mysql)
endif()### 改为如下
#if(QT_FEATURE_sql_mysql)add_subdirectory(mysql)
#endif()

再进入MySQL目录，找到MySQL目录下的CMakeList.txt ，这里是Qt官方的写法，这里使用的 cmake的模块化构建，如果安装了MySQL的库，那么不需要修改。如果没有安装MySQL的库，那么需要手动去配置 MySQL::MySQL的路径

qt_internal_add_plugin(QMYSQLDriverPluginOUTPUT_NAME qsqlmysqlPLUGIN_TYPE sqldriversSOURCESmain.cppqsql_mysql.cpp qsql_mysql_p.hDEFINESQT_NO_CAST_FROM_ASCIIQT_NO_CAST_TO_ASCIIQT_NO_CONTEXTLESS_CONNECTLIBRARIESMySQL::MySQLQt::CoreQt::CorePrivateQt::SqlPrivate
)qt_internal_force_macos_intel_arch(QMYSQLDriverPlugin)

这里直接展示配置后的结果

add_library(MySQL::MySQL INTERFACE IMPORTED)
set_target_properties(MySQL::MySQL PROPERTIESINTERFACE_INCLUDE_DIRECTORIES "D:/MySQL/mysql-9.2.0-winx64/include"INTERFACE_LINK_LIBRARIES "D:/MySQL/mysql-9.2.0-winx64/lib/libmysql.dll"
)qt_internal_add_plugin(QMYSQLDriverPluginOUTPUT_NAME qsqlmysqlPLUGIN_TYPE sqldriversSOURCESmain.cppqsql_mysql.cpp qsql_mysql_p.hDEFINESQT_NO_CAST_FROM_ASCIIQT_NO_CAST_TO_ASCIIQT_NO_CONTEXTLESS_CONNECTLIBRARIESMySQL::MySQLQt::CoreQt::CorePrivateQt::SqlPrivate
)qt_internal_force_macos_intel_arch(QMYSQLDriverPlugin)