Windows下Qt添加MySQL驱动的完整指南
在Windows系统中为Qt添加MySQL驱动,核心步骤是编译MySQL驱动插件并正确配置Qt项目,确保已安装Qt开发环境、MySQL数据库及对应的Connector/C++库,这是成功添加驱动的基础。

准备工作
- 安装MySQL Connector/C++:从MySQL官网下载与系统位数匹配的版本(如64位),安装时注意记录库文件的路径(通常包含
include和lib文件夹)。 - 确认Qt环境:打开Qt Creator,检查已安装的Qt版本及编译器类型(如MSVC或MinGW),需确保与MySQL库的编译方式一致。
编译MySQL驱动插件
- 定位Qt源码目录:进入Qt安装路径下的
Qt版本号\Src\qtbase\src\plugins\sqldrivers。 - 配置编译参数:在命令行中运行以下命令(以64位MSVC为例):
qmake -- MYSQL_INCDIR="C:/MySQL/connector/include" MYSQL_LIBDIR="C:/MySQL/connector/lib"
替换路径为实际Connector/C++的安装位置。
- 编译与部署:执行
nmake(MSVC)或mingw32-make(MinGW)编译,成功后,将生成的qsqlmysql.dll和qsqlmysqld.dll(调试版)复制到Qt版本号\plugins\sqldrivers目录。
配置Qt项目
- 项目文件设置:在
.pro文件中添加MySQL依赖:INCLUDEPATH += "C:/MySQL/connector/include" LIBS += -L"C:/MySQL/connector/lib" -lmysql
- 测试连接:在代码中使用以下示例验证驱动:
QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); db.setHostName("localhost"); db.setDatabaseName("testdb"); db.setUserName("root"); db.setPassword("password"); if (db.open()) { qDebug() << "MySQL连接成功!"; } else { qDebug() << "连接失败:" << db.lastError(); }
常见问题解决
- 驱动未加载:检查插件路径是否在Qt的
plugins\sqldrivers中,或通过QCoreApplication::addLibraryPath()添加自定义路径。 - 缺少依赖库:将MySQL的
libmysql.dll(位于Connector/C++的lib目录)复制到可执行文件同级目录或系统PATH路径中。 - 编译错误:确保Connector/C++与Qt使用相同的编译器(如MSVC 2019)和系统架构(64/32位)。
通过以上步骤,即可在Windows平台完成Qt与MySQL的集成,实现高效的数据库操作开发。
未经允许不得转载! 作者:HTML前端知识网,转载或复制请以超链接形式并注明出处HTML前端知识网。
原文地址:https://www.html4.cn/15775.html发布于:2026-09-09





