运维调试记录:QSqlDatabase: QMYSQL driver not loaded

本文详细介绍了在Qt5.3中遇到MySQL数据库驱动未加载错误时的两种解决方案:一是确保qsqlmysql.dll存在于plugins目录下;二是将libmysql.dll从MySQL安装目录复制到Qt安装的bin目录下。提供了获取驱动的链接。

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

在Qt 5.3中使用数据库连接时,弹出下面的错误:

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

从上面的错误可以看出,错误发生在MySQL数据库驱动并未加载

对于这种错误一般有两种解决方案:

第一种:无MySQL驱动。

在这种情况下,检查 Qt\5.3\msvc2013_64_opengl\plugins 目录下是否有qsqlmysql.dll,如果没有,就说明Qt没有相应的mysql驱动。这时,在QSqlDatabase: available drivers: QSQLITE QMYSQL QMYSQL3 QODBC QODBC3 QPSQL QPSQL7 报错中没有QMYSQL项。

解决方法是:拷贝qmysql.dll至plugins目录下。如何获取?http://blog.163.com/e_rommel/blog/static/187383045201292422139149/http://dev.wo.com.cn/bbs/viewthread.jsp?tid=140945&extra=page%3D1

第二种:库支持不完善。

解决方法是:将MySQL\MySQL Server 5.7\lib下的libmysql.dll拷贝至Qt\5.3\msvc2013_64_opengl\bin下即可。

### 解决方案 在 QT 中遇到 `QMYSQL driver not loaded` 的问题通常是由于 MySQL 驱动未能正确加载引起的。以下是可能导致该问题的原因以及解决方案: #### 1. **MySQL 插件路径配置** QT 安装目录下的插件路径可能未被正确识别,或者缺少必要的动态链接库 (DLL) 文件。确保以下条件满足: - 检查是否存在 `qsqlmysql.dll` 文件于 QT 安装目录中的 `plugins/sqldrivers/` 路径下[^1]。 - 如果上述路径不存在,则需手动构建 MySQL 驱动。 #### 2. **依赖项缺失** MySQL 驱动需要依赖 MySQL Connector/C 库 (`libmysql.dll`) 和其他系统 DLL 文件。如果这些文件丢失或版本不匹配,可能会导致驱动无法加载。 - 下载并安装适合系统的 [MySQL Connector/C](https://dev.mysql.com/downloads/connector/c/)。 - 将 `libmysql.dll` 放置到应用程序的工作目录或系统 PATH 环境变量中。 #### 3. **手动构建 MySQL 驱动** 如果默认的 MySQL 驱动不可用,可以通过源码自行构建: - 打开 QT 安装目录下的 `qtbase/src/plugins/sqldrivers/mysql.pro` 文件。 - 使用命令行工具进入该目录,并执行以下命令以完成构建过程: ```bash qmake "INCLUDEPATH+=C:\path\to\mysql\include" "LIBS+=C:\path\to\mysql\lib\libmysql.lib" nmake ``` 完成后会在 `sqldrivers/release/` 或 `sqldrivers/debug/` 目录生成新的 `qsqlmysql.dll` 文件。 #### 4. **环境变量设置** 确认已将 MySQL 动态链接库所在的路径添加至系统环境变量 `PATH` 中。这一步对于 Windows 平台尤为重要。 #### 5. **验证驱动加载状态** 通过调试代码检查驱动是否成功加载: ```cpp #include <QCoreApplication> #include <QSqlDatabase> #include <QDebug> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QStringList drivers = QSqlDatabase::drivers(); qDebug() << "Available SQL Drivers:" << drivers; if (!drivers.contains("QMYSQL")) { qWarning() << "QMYSQL driver is NOT available!"; } else { qDebug() << "QMYSQL driver is successfully loaded."; } return a.exec(); } ``` #### 6. **兼容性问题** 注意 QT 版本与 MySQL 驱动之间的兼容性。当前使用的 QT 6.8.1 可能存在某些特定限制,建议查阅官方文档了解最新支持情况[^4]。 --- ### 总结 以上方法涵盖了从基础排查到高级定制的过程。优先尝试调整插件路径和补充依赖项;若仍失败则考虑重新编译驱动程序。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值