【Qt】Qt5.12版本编译Oracle驱动教程

00. 目录

QT因为授权问题，默认是不支持Oracle数据库连接驱动的，需要自己解决, 该方法适用于QT5.12版本或者以上

01. Qt5.12安装

【Qt5.12】Qt5.12安装教程

02. Qt安装注意事项

安装Qt的时候只需要选择MinGW和Sources源码

03. Qt版本和Oracle安装路径说明

Qt版本是Qt5.12

Qt安装路径是H:\Qt\Qt5.12.2

Oracle客户端安装版本是Oracle 11g

Oracle客户端安装的路径是H:\app\deng\product\11.2.0\client_1

04. Qt5.12编译Oracle驱动(使用MinGW 64位)

step 1: 打开源码

打开目录H:H:\Qt\Qt5.12.2\5.12.2\Src\qtbase\src\plugins\sqldrivers\oci下的oci.pro文件

选择配置项目

直接编译出现如下错误

step 2: 修改配置文件(如果编译套件是64位的选择64位的库)

修改配置文件如下:

TARGET = qsqloci

HEADERS += $$PWD/qsql_oci_p.h
SOURCES += $$PWD/qsql_oci.cpp $$PWD/main.cpp

#注释该行
#QMAKE_USE += oci

#根据Oracle客户端安装路径 指定oci.dll
QMAKE_LFLAGS +=H:\app\deng\product\11.2.0\client_1\BIN\oci.dll

#根据Oracle客户端安装路径 指定头文件目录
INCLUDEPATH += H:\app\deng\product\11.2.0\client_1\oci\include

#根据安装的Oracle客户端指定libPath
LIBPATH += H:\app\deng\product\11.2.0\client_1\oci\lib\msvc

darwin:QMAKE_LFLAGS += -Wl,-flat_namespace,-U,_environ

OTHER_FILES += oci.json

PLUGIN_CLASS_NAME = QOCIDriverPlugin
include(../qsqldriverbase.pri)

红色部分为修改部分

step3: 编译

编译之后报错，错误信息如下

问题分析

在Qt5.12里面调用的是OCIBindByPos2（）函数，这个函数的第九个参数的数据类型是ub4*，但是根据oracle官方的说法：在这里找到的思路：是新的OCIBindByPos2（）函数和以前的OCIBindByPos（）函数有一定的区别，为了能在最新的Qt5.12上能成功编译Oracle驱动，我们需要对oci项目下的qsql_oci.cpp的1559行代码附近进行修改。

原来代码如下：

问题解决

oci项目下的qsql_oci.cpp的1559行代码附近进行修改。

修改之后内容如下：

// binding the column
r = OCIBindByPos(
    d->sql, &bindColumn.bindh, d->err, i + 1,
    bindColumn.data,
    bindColumn.maxLen,
    bindColumn.bindAs,
    bindColumn.indicators,
    reinterpret_cast(bindColumn.lengths),
    0,
    arrayBind ? bindColumn.maxarr_len : 0,
    arrayBind ? &bindColumn.curelep : 0,
    OCI_DEFAULT);

这么做是将OCIBindByPos2（）函数替换成OCIBindByPos（）但是OCIBindByPos（）函数的第九个参数是ub2*，但是实际上

bindColumn.length实际上是ub4*，因此需要一个强制转换，转换完毕之后，qmake，然后重新生成项目即可，这样就完全解决这个问题了。

step 4: 重新编译

之后再重新编译，就会发现编译通过了，这时候我们在Qt安装的根目录下面去找 “ H:\plugins ”会发现里面有一个“ sqldrivers ”文件夹，将sqldrivers中的动态库复制到Qt的H:\Qt\Qt5.12.2\5.12.2\mingw73_64\plugins\sqldrivers下面即可。

step 5: 测试

测试代码

    //1. 加载驱动
    QSqlDatabase db = QSqlDatabase::addDatabase("QOCI");

    //2. 设置主机名
    db.setHostName("192.168.21.25");

    //3. 设置数据库
    db.setDatabaseName("orcl");

    //4. 设置用户名
    db.setUserName("scott");

    //5. 设置密码
    db.setPassword("11");

    //6. 设置端口
    db.setPort(1521);

    //7. 打开数据库
    bool ok = db.open();
    if (ok)
    {
        qDebug() << "连接Oracle数据库ok ";
    }
    else
    {
        qDebug() << "连接Oracle数据库失败 " << db.lastError().text();
    }

    //8. 关闭连接
    if (db.isOpen())
    {
        db.close();
    }

测试结果：

注意

软件的发布和测试

软件发布，部署的时候，需要复制oci.dll 到与exe同级目录下。驱动一起放在 exe 同级下的/sqldrivers目录下。注意程序源代码要增加： QApplication::addLibraryPath("./plugins"); 让qt启用插件目录，例如上边的sqldrivers目录下各种驱动。

05. 赞赏