QT配置MySQL驱动及解决连接依赖的完整指南

Chloe

发布时间：2026-10-16 | 3人浏览过

原创

在QT开发中集成MySQL数据库需要正确配置驱动插件和运行库依赖。本文详细记录了从下载适配版本、部署dll文件到编写测试代码的全过程，特别解决了常见的"QMYSQL driver not loaded"及"Unable to load library libmysql"报错，确保数据库连接稳定可用。

准备条件与下载适配驱动

在使用QT访问MySQL之前，必须确认你的QT版本、编译器类型（如MSVC或MinGW）以及系统架构（32位或64位）。不同环境需要匹配不同的驱动包。

第1步：下载对应的Qt MySQL驱动包

根据你使用的QT版本选择相应的驱动文件。例如，若使用QT 5.15，应寻找与该版本匹配的驱动压缩包。请注意，驱动分为不同编译器版本，需确保与你的QT构建环境一致。

在资源页面中，找到与你系统位数和编译器对应的文件。比如64位机器配合MSVC2019编译器，通常下载名为 qsqlmysql.dll_Qt_SQL_driver_5.15.2_MSVC2019_64-bit.zip 的文件。

下载完成后，解压获取核心的动态链接库文件 qsqlmysql.dll。

第2步：安装驱动插件

将解压得到的 qsqlmysql.dll 文件粘贴至QT安装的插件目录中。路径结构通常为：

D:\Qt\5.15.2\msvc2019_64\plugins\sqldrivers\

注意：请根据实际安装路径调整上述路径，关键在于进入 sqldrivers 子文件夹。

验证驱动是否生效

驱动复制完成后，建议编写一个简单的C++程序来检测QT当前已加载的所有数据库驱动列表。如果列表中包含 QMYSQL，说明驱动插件已成功加载。

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QDebug>
#include <QStringList>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    
    // 输出可用数据库驱动列表
    qDebug() << "Available drivers:";
    QStringList drivers = QSqlDatabase::drivers();
    foreach(QString driver, drivers)
        qDebug() << driver;
        
    return a.exec();
}

编译并运行该程序，观察输出窗口。若成功显示 QMYSQL，则表明驱动注册阶段正常。

编写测试代码与处理运行时错误

驱动加载成功后，可以尝试建立实际的数据库连接。以下代码演示了如何初始化连接、创建表、插入数据并查询结果。

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    
    // 1. 添加MySQL驱动
    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
    
    // 2. 配置连接参数
    db.setHostName("localhost");
    db.setDatabaseName("test"); // 假设存在名为test的数据库
    db.setUserName("root");
    db.setPassword("YOUR DATABASE PASSWORD"); // 替换为你的密码
    
    // 3. 尝试打开连接
    if (!db.open()) {
        qDebug() << "Failed to connect to root mysql admin: " << db.lastError().text();
    } else {
        qDebug() << "open success";
    }
    
    QSqlQuery query(db);
    
    // 4. 操作数据库
    // 注意：VARCHAR类型必须指定长度，否则可能导致SQL语法错误或驱动异常
    query.exec("create table student(id int primary key,name varchar(20))");
    
    query.exec("insert into student values(1,'xiaogang')");
    query.exec("insert into student values(2,'xiaoming')");
    query.exec("insert into student values(3,'xiaohong')");
    
    // 5. 查询数据
    query.exec("select id,name from student where id >= 1");
    while(query.next())
    {
        int value0 = query.value(0).toInt();
        QString value1 = query.value(1).toString();
        qDebug() << value0 << value1 ;
    }
    
    // 关闭数据库连接
    db.close();
    return a.exec();
}