Docker部署Django应用遇cx_Oracle.DatabaseError: DPI-1047错误求助

核心原因 #

Docker容器是独立的隔离环境，你在宿主机Ubuntu Server上安装的instantclient、设置的环境变量，容器完全无法访问。本地直接运行脚本用的是宿主机环境，而docker-compose up启动的是容器内环境，这就是问题的本质差异。

具体解决方案 #

方案1：将Oracle Instant Client打包进Docker镜像 #

这是最稳定的解决方式，把客户端库集成到镜像中：

• 下载对应版本的Oracle Instant Client压缩包（如instantclient-basic-linux.x64-23.4.0.24.05.zip），放到项目根目录。
• 修改项目的Dockerfile，添加以下步骤：

# 基于你的Python基础镜像，示例用python:3.11-slim
RUN apt-get update && apt-get install -y unzip libaio1

# 复制并解压客户端包
COPY instantclient-basic-linux.x64-23.4.0.24.05.zip /tmp/
RUN unzip /tmp/instantclient-basic-linux.x64-23.4.0.24.05.zip -d /opt/oracle/
RUN rm /tmp/instantclient-basic-linux.x64-23.4.0.24.05.zip

# 设置容器内的环境变量
ENV LD_LIBRARY_PATH=/opt/oracle/instantclient_23_4:$LD_LIBRARY_PATH
ENV ORACLE_HOME=/opt/oracle/instantclient_23_4

• 调整Python代码中的初始化路径，改为容器内的路径：

cx_Oracle.init_oracle_client(lib_dir="/opt/oracle/instantclient_23_4")

• 重新构建镜像并启动服务：

docker-compose build
docker-compose up

方案2：通过卷挂载宿主机的Instant Client到容器 #

若不想每次构建镜像都打包客户端，可通过卷挂载共享宿主机的客户端库：

• 修改docker-compose.yml，添加卷挂载和环境变量配置：

services:
  django-app:
    # 其他原有配置...
    volumes:
      - /root/lib/oracle/instantclient_23_4:/opt/oracle/instantclient_23_4
    environment:
      - LD_LIBRARY_PATH=/opt/oracle/instantclient_23_4:$LD_LIBRARY_PATH
      - ORACLE_HOME=/opt/oracle/instantclient_23_4

• 同步调整Python代码中的lib_dir为容器内的挂载路径：

cx_Oracle.init_oracle_client(lib_dir="/opt/oracle/instantclient_23_4")

• 启动服务：

docker-compose up

关键注意事项 #

• 确保容器操作系统与宿主机的Instant Client版本兼容（均为64位Linux）。
• 检查容器内/opt/oracle/instantclient_23_4目录下是否存在libclntsh.so文件，避免挂载或解压错误。
• 若容器以非root用户运行，需确保该用户对Instant Client目录有读取权限。

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