QMYSQL driver not loaded错误解决方案

最新推荐文章于 2025-05-29 11:52:38 发布

原创最新推荐文章于 2025-05-29 11:52:38 发布 · 4.5k 阅读

29 ·

CC 4.0 BY-SA版权

文章标签：

#qt5 #c++

C++ 同时被 2 个专栏收录

3 篇文章

订阅专栏

3 篇文章

订阅专栏

解决Qt应用程序连接MySQL数据库失败的问题，通过编译QMYSQL驱动并添加MySQL扩展包，实现Qt与MySQL数据库的成功连接。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在使用Qt操作MySQL数据库过程中，使用Qt编写好连接MySQL数据库的的代码后，编译调试时报错QSqlDatabase: QMYSQL driver not loaded，意味着Qt应用程序与MySQL数据库连接失败。报错如下图所示：

("QSQLITE", "QODBC", "QODBC3", "QPSQL", "QPSQL7")
QSqlDatabase: QMYSQL driver not loaded
QSqlDatabase: available drivers: QSQLITE QODBC QODBC3 QPSQL QPSQL7
"Driver not loaded Driver not loaded"

本工程项目（解决方案）开发环境为：

（1）操作系统：Windows10

（2）MySQL版本为：8.0 MySql下载

（3）Qt版本为：5.14.1 Qt5.14.1下载

（4）QtCreator版本为：4.11.0

分析”QSqlDatabase: QMYSQL driver not loaded”出现的原因

根据上图的报错提示，查阅官方文档，链接：https://doc.qt.io/qt-5/sql-driver.html#qmysql-for-mysql-4-and-higher，得到相关信息，如下

（1）Qt SQL模块使用驱动程序插件与不同的数据库api进行通信。

（2）支持的数据库如下：

Driver name	DBMS
QDB2	IBM DB2 (version 7.1 and above)
QIBASE	Borland InterBase
QMYSQL	MySQL (version 5.0 and above)
QOCI	Oracle Call Interface Driver
QODBC	Open Database Connectivity (ODBC) - Microsoft SQL Server and other ODBC-compliant databases
QPSQL	PostgreSQL (versions 7.3 and above)
QSQLITE2	SQLite version 2Note: obsolete since Qt 5.14
QSQLITE	SQLite version 3
QTDS	Sybase Adaptive ServerNote: obsolete since Qt 4.7

根据报错信息提示可用的drivers是： QSQLITE QODBC QODBC3 QPSQL QPSQL7，其中没有QMYSQL驱动。于是定位问题出现的原因是：缺少QMYSQL驱动。

编译MySQL驱动

(一)编译驱动

查阅计算机Qt安装路径：E:\ProgramData\Qt\Qt5.14.1\5.14.1\mingw73_64\plugins\sqldrivers 的sqldrivers插件，如下
在这里插入图片描述
　发现其中没有与MySQL相关的驱动插件。

原来Qt5.14版本下不包含有驱动MySQL的驱动插件，那么就需要自己编译插件了。编译插件的过程如下：

1、使用QtCreator打开mysql.pro项目E:\ProgramData\Qt\Qt5.14.1\5.14.1\Src\qtbase\src\plugins\sqldrivers\mysql

打开项目文件（初始内容）如下
在这里插入图片描述
对照的修改为以下内容

给出代码，自行复制替换

TARGET = qsqlmysql

HEADERS += $$PWD/qsql_mysql_p.h
SOURCES += $$PWD/qsql_mysql.cpp $$PWD/main.cpp

#QMAKE_USE += mysql

OTHER_FILES += mysql.json

PLUGIN_CLASS_NAME = QMYSQLDriverPlugin
include(../qsqldriverbase.pri)
#该路径是的Mysql的头文件（include）路径
INCLUDEPATH +="E:\Program Files\MySQL\mysql-8.0.18-winx64\include"
#这是MySQl的库文件路径
LIBS +="E:\Program Files\MySQL\mysql-8.0.18-winx64\lib\libmysql.lib"
#为了方便查找，不妨增加一条语句，该语句用来指明编译后的结果输出的位置
DESTDIR = ../mysql/lib/

添加完之后编译程序（注意：此处使用的是MinGw64位）
在这里插入图片描述
编译成功后E:\ProgramData\Qt\Qt5.14.1\5.14.1\Src\qtbase\src\plugins\sqldrivers\mysql目录下会多出一个lib目录

在这里插入图片描述

2、将这三个文件复制到E:\ProgramData\Qt\Qt5.14.1\5.14.1\mingw73_64\plugins\sqldrivers中

在这里插入图片描述

（二）添加MySql扩展包

添加MySQL连接的扩展包libmysql.dll和libmysql.lib，这个包在我们的MySql安装目录E:\Program Files\MySQL\mysql-8.0.18-winx64\lib中;
将扩展包添加到Qt安装目录E:\ProgramData\Qt\Qt5.14.1\5.14.1\mingw73_64\bin中：
在这里插入图片描述
至此，Qt可以连接到MySQL数据库了。