Linux系統下Qt5無法連接MySQL數據庫的解決方法

Linux平台下解決Qt5連接mysql數據庫的問題：輸入sudo apt-get install libqt5sql5-mysql解決，這種方法只能解決Qt是用sudo apt-get install qt-sdk命令裝的低版本的Qt5（如5.2.x）缺少MySQL驅動問題，如果你的Qt5版本為5.7.X，那麼就不能用這種方法解決，請參考下面的方法。

傳統解決方法：

一、解決問題

　　本文解決在Ubuntu14.04系統下，Qt5無法連接MySQL數據庫的問題（Qt5缺少MySQL驅動，Qt5缺少libqsqlmysql.so動態庫，如何安裝libqsqlmysql庫，如何用Qt5源碼編譯生成libqsqlmysql庫）

二、問題現象

　　編譯運行Qt連接MySQL數據庫程序的時候，控制台會報如下錯誤：

　　QSqlDatabase: QMYSQL driver not loaded
　　QSqlDatabase: available drivers: QSQLITE

三、問題原因

　　用Qt連接MySQL，Qt會去加載libqsqlmysql.so動態庫，如果加載不到或者加載的庫有問題，都會導致Qt提示driver not loaded。

　　（1）加載不到：Qt安裝目錄下的sqldrivers目錄中沒有libqsqlmysql.so文件（我的路徑：/opt/Qt5.7.0/5.7/gcc_64/plugins/sqldrivers）

　　（2）庫有問題：進入Qt的sqldrivers目錄，執行“ldd libqsqlmysql.so”命令，會出現“libmysqlclient_r.so.16 => not found”等等not found提示，如下圖：

四、解決方法

思路：自己手動編譯mysql驅動的源碼，生成libqsqlmysql.so庫，然後把這個庫拷貝到Qt的sqldrivers目錄下

1、編譯libqsqlmysql.so之前需要拿到Qt連接mysql驅動的源碼，因此先去Qt官網下載Qt安裝包qt-opensource-linux-x64-5.7.0.run

　　（1）打開網址：https://www.qt.io/，點擊Download

　　（2）做一套選擇題，一路選下去：

　　（也可以直接打開這個網址（可能失效）：https://www.qt.io/download-open-source/，選View All Downloads）

　　（3）選擇查看所有的下載資源（View All Downloads）

　　（4）選擇下載的版本（我選的是Qt 5.7.0 for Linux64-bit）

 2、安裝Qt

　　（1）運行安裝包（我是把Qt安裝到系統根目錄下的）

　　若想安裝到系統根目錄下，則執行：sudo ./qt-opensource-linux-x64-5.7.0.run

　　若想安裝到用戶根目錄下，則執行：./qt-opensource-linux-x64-5.7.0.run

　　（2）選擇安裝源碼組件

3、編譯生成Qt連接MySql的驅動，即libqsqlmysql.so

　　（1）進入Qt安裝目錄，找到MySql驅動源碼目錄

　　參考我的目錄：/opt/Qt5.7.0/5.7/Src/qtbase/src/plugins/sqldrivers/mysql

　　注：每個人的源碼目錄可能不同，找的時候參考Src，qtbase、plugins、sqldrivers、mysql目錄去找就沒錯。

　　（2）執行qmake生成Makefile。

　　注：如果之前安裝過其他Qt版本，那麼可能執行的是其他版本qmake。

　　不妨執行“qmake -v”命令查看一下qmake的版本是否與我們剛安裝的Qt的qmake一致。

　　最佳方案：首先找到新安裝的Qt的qmake所在路徑，然後找到mysql.h頭文件所在路徑，最後執行qmake命令生成Makefile（建議執行qmake的時候帶上qmake的路徑）

　　qmake命令：sudo /opt/Qt5.7.0/5.7/gcc_64/bin/qmake  "INCLUDEPATH+=/usr/include/mysql" "LIBS+=-L/usr/lib -lmysqlclient_r" mysql.pro

　　執行的過程中如果報錯，仔細看錯誤是找不到目錄還是找不到庫文件，按照上面的方法去找或者去安裝庫，在執行qmake命令就可以了。

我以我的系統為例操作一下：

　　（3）生成libqsqlmysql.so

　　執行命令：make

　　注意make命令輸出的最後幾行，指出了生成的libqsqlmysql.so位置。

4、把生成libqsqlmysql.so拷貝到sqldrivers文件夾下（我是拷貝到：/opt/Qt5.7.0/5.7/gcc_64/plugins/sqldrivers）

五、測試樣例

　　到這裡，Qt就已經可以連接MySql數據庫了，拷貝這個程序去試試吧。

　　pro文件中添加這句話“QT += sql”，讓Qt加載數據庫模塊

 1 #include <QCoreApplication>
 2 #include <QSqlDatabase>
 3 #include <QSqlQuery>
 4 #include <QSqlTableModel>
 5 #include <QSqlError>
 6 #include <QDebug>
 7 
 8 int main(int argc, char *argv[])
 9 {
10     QCoreApplication app(argc, argv);
11     QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); //database driver
12     db.setHostName("localhost");  //database ip address
13     db.setUserName("username");   //database username
14     db.setPassword("password");   //database password
15     db.setDatabaseName("HC");     //database table name
16     if (true == db.open())
17     {
18         qDebug() << "succ";
19     }
20     else
21     {
22         qDebug() << "failed";
23         exit(0);
24     }
25     return app.exec();
26 }