Linux下Qt连接MySQL数据库报错：driver not loaded怎么办？

Question

在Linux下使用Qt连接MySQL数据库时，如果遇到“driver not loaded”错误，通常是由于缺少或未正确配置MySQL驱动导致的。以下是常见原因及解决方法： 1. **未安装Qt MySQL驱动**：确保已安装`qtbase5-sql-drivers`或`qt5-qtbase-mysql`（根据发行版不同可能有所不同）。可通过命令`sudo apt-get install qtbase5-dev`（Ubuntu）或`sudo yum install qt5-qtbase-mysql`（CentOS）安装。 2. **驱动路径未加载**：检查是否将MySQL驱动路径添加到Qt插件目录。例如，编译并安装`qsqlmysql`驱动后，需将其放置于`/usr/lib/x86_64-linux-gnu/qt5/plugins/sqldrivers/`目录下。 3. **缺少MySQL开发库**：确保系统已安装MySQL开发库，如`libmysqlclient-dev`，否则无法正确编译和加载驱动。 4. **环境变量问题**：确认`LD_LIBRARY_PATH`包含MySQL库路径，并在程序中通过` QSqlDatabase::addDatabase("QMYSQL")`明确指定驱动类型。 若问题仍未解决，建议检查日志输出，进一步定位具体原因。

Answer 1

1. 初步排查：确认Qt MySQL驱动是否安装

在Linux环境下使用Qt连接MySQL数据库时，如果遇到“driver not loaded”错误，首先需要确认是否已正确安装Qt的MySQL驱动。不同Linux发行版的包管理器可能提供不同的驱动名称。

• Ubuntu/Debian: 使用命令 sudo apt-get install qtbase5-sql-drivers 或 sudo apt-get install libqt5sql5-mysql 安装。
• CentOS/RHEL: 使用命令 sudo yum install qt5-qtbase-mysql 安装。

安装完成后，可以通过以下代码验证驱动是否可用：

QStringList drivers = QSqlDatabase::drivers();
foreach(QString driver, drivers) {
    qDebug() << "Available SQL driver:" << driver;
}

如果输出中未包含“QMYSQL”，则说明驱动尚未正确安装或配置。

2. 深入分析：检查驱动路径与环境变量

即使驱动已安装，仍需确保其路径被Qt加载。通常，MySQL驱动文件（如libqsqlmysql.so）应位于Qt插件目录下，例如：

• /usr/lib/x86_64-linux-gnu/qt5/plugins/sqldrivers/（适用于Ubuntu）
• /usr/lib64/qt5/plugins/sqldrivers/（适用于CentOS）

如果驱动文件未在此目录中，可通过以下步骤解决：

1. 编译并安装qsqlmysql驱动。
2. 将生成的libqsqlmysql.so复制到上述目录。

此外，还需确认环境变量LD_LIBRARY_PATH是否包含MySQL库路径。例如：

export LD_LIBRARY_PATH=/usr/lib/mysql:$LD_LIBRARY_PATH

最后，在程序中通过以下代码明确指定驱动类型：

QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");

3. 高级诊断：检查依赖项与日志

如果上述步骤仍未解决问题，可能是由于缺少必要的MySQL开发库或依赖项导致的。以下是进一步的排查方法：

问题	解决方案
缺少MySQL开发库	安装libmysqlclient-dev（Ubuntu）或mysql-devel（CentOS）。
驱动编译失败	确保已安装g++、make等开发工具，并重新编译驱动。
运行时错误	检查日志输出，定位具体错误信息。

以下是驱动编译的典型流程：

cd /path/to/qtbase/src/plugins/sqldrivers
qmake -- MYSQL_INCDIR=/usr/include/mysql MYSQL_LIBDIR=/usr/lib/mysql
make
sudo make install

4. 流程图：系统化排查步骤

为了更清晰地展示排查过程，以下是一个流程图：

graph TD;
    A[开始] --> B{驱动是否安装};
    B --否--> C[安装驱动];
    B --是--> D{路径是否正确};
    D --否--> E[修复路径];
    D --是--> F{环境变量是否设置};
    F --否--> G[设置环境变量];
    F --是--> H{日志是否正常};
    H --否--> I[检查依赖];
    H --是--> J[结束];

通过以上步骤，可以逐步定位并解决“driver not loaded”错误的根本原因。