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 windows 无法连接_Qt5 Mysql

 

 

四、解决方法

思路:自己手动编译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

   

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_02

 

  (2)做一套选择题,一路选下去:

  (也可以直接打开这个网址(可能失效):https://www.qt.io/download-open-source/,选View All Downloads)

  

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_03

  

mysql windows 无法连接_libqsqlmysql.so_04

  

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_05

  

mysql windows 无法连接_libqsqlmysql.so_06

  

mysql windows 无法连接_Qt5 Mysql_07

  

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_08

 

  (3)选择查看所有的下载资源(View All Downloads)

   

mysql windows 无法连接_Qt5 Mysql_09

  (4)选择下载的版本(我选的是Qt 5.7.0 for Linux64-bit)

  

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_10

 2、安装Qt

  (1)运行安装包(我是把Qt安装到系统根目录下的)

  若想安装到系统根目录下,则执行:sudo ./qt-opensource-linux-x64-5.7.0.run

  若想安装到用户根目录下,则执行:./qt-opensource-linux-x64-5.7.0.run

 

  (2)选择安装源码组件

  

mysql windows 无法连接_Linux系统下Qt5无法连接MySQL_11

 

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目录去找就没错。

  

mysql windows 无法连接_Qt 连接 MySQL_12

 

  (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命令就可以了。

 

  我以我的系统为例操作一下:

  

mysql windows 无法连接_Qt5 Mysql_13

  

mysql windows 无法连接_Qt5 Mysql_14

  

mysql windows 无法连接_Qt5 Mysql_15

              

mysql windows 无法连接_Qt 连接 MySQL_16

   

  (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 }



楼主亲测可用!

除了博文中说的错误情况外,楼主在操作的过程中还遇到:



/usr/bin/ld: cannot find -lssl



/usr/bin/ld: cannot find -lcrypto  



...



具体如下图所示:

mysql windows 无法连接_libqsqlmysql.so_17



①中的问题楼主因为没有使用到这两个库,所以先从Makefile中删除了-lssl 和  -lcrypto 这两个编译选项,具体如果要用的话就得自己装相关的库了;


②中出现的问题虽然和网络上很多文章类似,但是原因各不相同,楼主就是因为系统中缺少①中用到的库,最终的原因都是缺少了libqsqlmysql.so中需要的部分库导致的,解决方案就是不需要用到的库可以先从Makefile中去掉依赖的编译选项,或者装上相应的库也可以。