Windows下Qt添加MySQL驱动的完整指南

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

WindowsQt如何添加MySQL驱动,WindowsQt便捷添加MySQL驱动

准备工作

  1. 安装MySQL Connector/C++:从MySQL官网下载与系统位数匹配的版本(如64位),安装时注意记录库文件的路径(通常包含includelib文件夹)。
  2. 确认Qt环境:打开Qt Creator,检查已安装的Qt版本及编译器类型(如MSVC或MinGW),需确保与MySQL库的编译方式一致。

编译MySQL驱动插件

  1. 定位Qt源码目录:进入Qt安装路径下的Qt版本号\Src\qtbase\src\plugins\sqldrivers
  2. 配置编译参数:在命令行中运行以下命令(以64位MSVC为例):
    qmake -- MYSQL_INCDIR="C:/MySQL/connector/include" MYSQL_LIBDIR="C:/MySQL/connector/lib"

    替换路径为实际Connector/C++的安装位置。

  3. 编译与部署:执行nmake(MSVC)或mingw32-make(MinGW)编译,成功后,将生成的qsqlmysql.dllqsqlmysqld.dll(调试版)复制到Qt版本号\plugins\sqldrivers目录。

配置Qt项目

  1. 项目文件设置:在.pro文件中添加MySQL依赖:
    INCLUDEPATH += "C:/MySQL/connector/include"
    LIBS += -L"C:/MySQL/connector/lib" -lmysql
  2. 测试连接:在代码中使用以下示例验证驱动:
    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