如何在Dockerfile中切换python-oracledb至厚模式连接Oracle 11.2（Airflow环境）

针对Oracle 11.2不支持thin模式的问题，下面是修改后的Dockerfile，专门配置python-oracledb以厚模式运行，适配Airflow 2.5.0环境：

FROM apache/airflow:2.5.0

# 安装Python依赖：替换cx_oracle为python-oracledb，保留其他必要包
RUN pip install python-oracledb \
    airflow-code-editor \
    black \
    --no-cache-dir apache-airflow-providers-oracle

USER root

# 安装系统依赖，合并命令减少镜像层数
RUN apt-get update && apt-get install -y \
    libaio-dev \
    libaio1 \
    build-essential \
    unzip \
    curl && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

# 配置Oracle Instant Client
RUN mkdir -p /opt/oracle
COPY instantclient-basic-linux.x64-21.9.0.0.0dbru.zip /tmp
COPY instantclient-sdk-linux.x64-21.9.0.0.0dbru.zip /tmp

RUN unzip /tmp/instantclient-basic-linux.x64-21.9.0.0.0dbru.zip -d /opt/oracle && \
    unzip /tmp/instantclient-sdk-linux.x64-21.9.0.0.0dbru.zip -d /opt/oracle && \
    mv /opt/oracle/instantclient_21_9 /opt/oracle/instantclient && \
    # 修正软链接：指向当前安装的21.9版本库，而非11.1
    ln -s /opt/oracle/instantclient/libclntsh.so.21.1 /opt/oracle/instantclient/libclntsh.so && \
    ln -s /opt/oracle/instantclient/libocci.so.21.1 /opt/oracle/instantclient/libocci.so && \
    rm -rf /tmp/instantclient*

# 配置系统库加载路径
RUN echo '/opt/oracle/instantclient/' | tee -a /etc/ld.so.conf.d/oracle_instant_client.conf && ldconfig

USER airflow

# 设置环境变量：启用python-oracledb厚模式，配置客户端路径
ENV ORACLE_HOME="/opt/oracle/instantclient"
ENV OCI_LIB_DIR="/opt/oracle/instantclient"
ENV OCI_INCLUDE_DIR="/opt/oracle/instantclient/sdk/include"
ENV LD_LIBRARY_PATH="/opt/oracle/instantclient:$LD_LIBRARY_PATH"
ENV PYTHON_ORACLEDB_THICK_MODE=1

关键修改说明 #

• 替换驱动依赖：移除cx_oracle，改用python-oracledb——这是Oracle官方推出的新一代驱动，完全兼容旧版Oracle数据库，且原生支持厚模式切换。
• 修正软链接：原Dockerfile错误链接了11.1版本的库，但我们安装的是21.9的Instant Client，必须对应链接当前版本的库文件，否则会出现加载失败的问题。
• 默认启用厚模式：通过环境变量PYTHON_ORACLEDB_THICK_MODE=1，让python-oracledb在初始化时自动使用厚模式，无需在DAG代码中手动调用初始化方法。
• 优化镜像构建：合并apt-get安装命令、清理缓存，减少镜像体积和构建时间；调整用户切换顺序，避免不必要的权限切换。

可选：DAG代码中显式初始化（如果需要） #

如果环境变量未生效，可在DAG代码中显式初始化厚模式：

import oracledb
from airflow import DAG

# 初始化Oracle厚模式客户端
oracledb.init_oracle_client(lib_dir="/opt/oracle/instantclient")

# 后续编写DAG逻辑...

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