运行连接Oracle数据库的Nest.js Docker镜像遇DPI-1047错误如何解决？

问题原因 #

错误提示找不到/usr/lib/oracle/instantclient_21_8/libclntsh.so，说明镜像构建时未正确安装Oracle Instant Client，或缺少必要的软链接、环境变量配置。

解决步骤 #

1. 修改Dockerfile，完善Instant Client安装流程 #

在Dockerfile中添加以下步骤，确保客户端库正确部署：

# 安装Oracle客户端依赖（Debian/Ubuntu基础镜像）
RUN apt-get update && apt-get install -y libaio1 unzip && rm -rf /var/lib/apt/lists/*

# 复制并解压Instant Client包
COPY instantclient-basiclite-linux.zip /tmp/
RUN unzip /tmp/instantclient-basiclite-linux.zip -d /usr/lib/oracle/ && \
    # 重命名目录匹配报错中的路径
    mv /usr/lib/oracle/instantclient* /usr/lib/oracle/instantclient_21_8 && \
    # 创建软链接，因为Oracle驱动需要无版本号的libclntsh.so
    ln -s /usr/lib/oracle/instantclient_21_8/libclntsh.so.21.1 /usr/lib/oracle/instantclient_21_8/libclntsh.so && \
    # 清理临时文件
    rm /tmp/instantclient-basiclite-linux.zip

# 设置环境变量，让系统能找到客户端库
ENV LD_LIBRARY_PATH=/usr/lib/oracle/instantclient_21_8:$LD_LIBRARY_PATH
ENV ORACLE_HOME=/usr/lib/oracle/instantclient_21_8

2. 适配Alpine基础镜像的特殊处理 #

如果你的Docker基础镜像是Alpine（使用musl libc而非glibc），需要替换为Alpine版本的Instant Client包（instantclient-basiclite-linux-musl.zip），并调整依赖安装命令：

RUN apk add --no-cache libaio unzip
# 后续解压、软链接、环境变量配置步骤同上方，注意替换zip文件名

3. 验证修复效果 #

• 重新构建镜像：

  docker build -t nest-oracle-app .
  

• 启动容器后，进入容器检查文件和环境变量：

  docker exec -it <你的容器ID> bash
  # 检查libclntsh.so是否存在
  ls /usr/lib/oracle/instantclient_21_8/libclntsh.so
  # 检查环境变量
  echo $LD_LIBRARY_PATH
  

关键注意事项 #

• 确保Instant Client的版本与报错路径中的21_8完全匹配，解压后的目录名必须一致。
• 不要跳过libaio1依赖安装，Oracle客户端运行依赖该库。

内容的提问来源于stack exchange，提问作者MARCOS FELIPE BARBOSA DE CARVA