Mac M1 Docker环境下Oracle 11g XE与Qt连接及驱动参数问题

核心问题解答 #

QSqlDatabase::addDatabase("")的引号内应填写**"QOCI"**，而非Windows平台常用的"QODBC"。QOCI是Qt基于Oracle Call Interface（OCI）实现的数据库驱动，专门适配macOS/Linux平台的Oracle连接需求。

前置准备 #

• Oracle Instant Client：Oracle 11g XE无arm64原生版本，推荐安装19c arm64版本的Instant Client（可向下兼容11g），解压后放置到/opt/oracle/instantclient_19_8这类固定目录。
• 环境变量配置：在终端配置环境变量（可写入~/.zshrc或~/.bashrc实现永久生效）：

  export DYLD_LIBRARY_PATH=/opt/oracle/instantclient_19_8:$DYLD_LIBRARY_PATH
  export ORACLE_HOME=/opt/oracle/instantclient_19_8
  

• Qt QOCI驱动编译：Qt默认不自带QOCI驱动，需手动编译：
  1. 进入Qt源码的qtbase/src/plugins/sqldrivers/oci目录
  2. 执行qmake指定Instant Client路径：

     qmake "INCLUDEPATH+=/opt/oracle/instantclient_19_8/sdk/include" "LIBS+=-L/opt/oracle/instantclient_19_8 -lclntsh"
     

  3. 编译并安装驱动：

     make && make install
     

  编译完成后，驱动会自动安装到Qt的sqldrivers插件目录（如Qt/6.5.3/macos/lib/plugins/sqldrivers）。

连接代码示例 #

#include <QSqlDatabase>
#include <QDebug>
#include <QSqlError>

int main() {
    QSqlDatabase db = QSqlDatabase::addDatabase("QOCI");
    db.setHostName("localhost");       // Docker映射的主机地址
    db.setPort(1521);                  // Docker映射的Oracle端口
    db.setDatabaseName("XE");          // Oracle 11g XE默认服务名
    db.setUserName("SYSTEM");          // Oracle默认管理员用户
    db.setPassword("your_oracle_pwd"); // Docker启动时设置的密码

    if (db.open()) {
        qDebug() << "Oracle数据库连接成功";
        // 执行数据库操作...
        db.close();
    } else {
        qDebug() << "连接失败：" << db.lastError().text();
    }
    return 0;
}

Docker Oracle配置注意事项 #

• 使用兼容的Oracle 11g XE镜像（如gvenzl/oracle-xe:11）启动容器，确保端口映射正确：

  docker run -d -p 1521:1521 -e ORACLE_PASSWORD=your_password gvenzl/oracle-xe:11
  

• 先通过sqlplus验证Oracle容器可正常访问：

  sqlplus system/your_password@localhost:1521/XE
  

内容的提问来源于stack exchange，提问作者Chayma