Qt访问Mysql数据库报错：QSqlDatabase: QMYSQL driver not loaded的解决方案

最新推荐文章于 2025-11-25 14:24:34 发布

原创最新推荐文章于 2025-11-25 14:24:34 发布 · 3.5k 阅读

25 ·

CC 4.0 BY-SA版权

文章标签：

#数据库

环境：

Windows11+Qt5.14.2+MySql8.1

问题：

使用Qt的QSqlDatabase库访问Mysql数据库时出错，打印

QSqlDatabase: QMYSQL driver not loaded
QSqlDatabase: available drivers: QSQLITE QODBC QODBC3 QPSQL QPSQL7
Open failed.

问题分析：

从上面的错误提示来看，是qt中没有Mysql的驱动，在qt的安装目录下查找，确实没有mysql驱动

通过上网搜索，发现是从Qt5.x的某个版本后，默认不提供mysql的驱动，需要用源码编译

解决步骤：

1.下载qt源码。

由于我安装qt的时候没有选择安装src，又不想重装，所以直接从官网下载源码，下载地址为Index of /archive/qt/5.14/5.14.2/submodules，需要跟你的qt版本匹配。

只下载qtbase源码，解压缩后放到我的qt安装目录的E:\Qt\Qt5.14.2\5.14.2\Src目录下

2.编译mysql驱动。

找到E:\Qt\Qt5.14.2\5.14.2\Src\qtbase-everywhere-src-5.14.2\src\plugins\sqldrivers\mysql路径，用qt打开

做如下修改：

将QMAKE_USE += mysql注释掉
添加：
INCLUDEPATH +="E:\Program Files\MySQL\MySQL Server 8.1\include" #mysql头文件
LIBS +="E:\Program Files\MySQL\MySQL Server 8.1\lib\libmysql.lib" #myslq库文件
DESTDIR = ../mysql/mysqlDll/ #编译生成文件的存放位置

然后在上层目录下修改qsqldriverbase.pri文件如下：

然后构建项目，正常应该可以构建成功。

我之前使用的是MinGW 32bit构建，但是我的mysql是64位的（mysql查看位数：命令行中输入mysql.exe --version），所以会编译失败，重新选择Kits为MinGW 64bit后构建成功。

3.构建成功后，在E:\Qt\Qt5.14.2\5.14.2\Src\qtbase-everywhere-src-5.14.2\src\plugins\sqldrivers\mysql\mysqlDll目录有下面三个文件

把这三个文件拷贝到qt对应编译器的sql驱动目录下

同时在Mysql安装目录的lib下，找到libmysql.dll，拷贝到E:\Qt\Qt5.14.2\5.14.2\mingw73_64\bin目录下。

至此Qt的mysql驱动安装完成。

新问题及解决办法：

此时重新构建项目，然后运行，又出现如下错误打印：

QSqlDatabase: QMYSQL driver not loaded
QSqlDatabase: available drivers: QSQLITE QMYSQL QMYSQL3 QODBC QODBC3 QPSQL QPSQL7
Open failed.

Qt中这时已经包含了mysql驱动，但是依然没有加载成功。经查还需要把mysql的bin路径和lib路径加入系统环境变量，如下：

添加完成后，重启qtcreator重新构建和运行项目，此时访问Mysql数据库成功。