解决问题 Qt + MySql："QSqlDatabase: QMYSQL driver not loaded"

### 解决方案 在 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]。 --- ### 总结 以上方法涵盖了从基础排查到高级定制的过程。优先尝试调整插件路径和补充依赖项；若仍失败则考虑重新编译驱动程序。