Windows10下Docker容器中Node.js连Oracle报DPI-1047错误求助

问题原因 #

本地Windows环境已配置Oracle客户端库，Node.js服务能正常连接Oracle；但Docker容器基于Linux镜像（node:latest默认是Linux版本），容器内未安装64位Oracle客户端库，导致node-oracledb无法找到依赖的libclntsh.so文件，触发DPI-1047错误。

解决方案 #

方案一：手动在Node镜像中安装Oracle Instant Client #

修改你的Dockerfile，添加Oracle客户端安装步骤：

FROM node:latest

# 安装Oracle客户端依赖的系统库
RUN apt-get update && apt-get install -y libaio1 unzip && rm -rf /var/lib/apt/lists/*

# 配置Oracle客户端环境变量
ENV ORACLE_CLIENT_VERSION=19.19.0.0.0
ENV ORACLE_HOME=/opt/oracle/instantclient_19_19
ENV LD_LIBRARY_PATH=$ORACLE_HOME:$LD_LIBRARY_PATH

# 下载并解压Oracle Instant Client Basic包
RUN curl -o instantclient-basic.zip https://download.oracle.com/otn_software/linux/instantclient/instantclient-basic-linux.x64-${ORACLE_CLIENT_VERSION}.zip && \
    unzip instantclient-basic.zip -d /opt/oracle && \
    rm instantclient-basic.zip

WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 9000
CMD ["npm", "start"]

方案二：使用Oracle Linux基础镜像（更简便） #

Oracle Linux官方源提供预编译的Oracle客户端包，无需手动下载解压：

FROM oraclelinux:8-slim

# 安装Node.js和Oracle Instant Client
RUN dnf install -y oracle-nodejs-release-el8 oracle-instantclient-release-el8 && \
    dnf install -y nodejs oracle-instantclient-basic && \
    dnf clean all

WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 9000
CMD ["npm", "start"]

注意事项 #

• 确保node-oracledb版本与Oracle Instant Client版本兼容（推荐使用19c或21c客户端，适配主流node-oracledb版本）。
• 验证容器与Oracle数据库的网络连通性：确认数据库地址在容器网络中可访问，默认端口1521已开放。

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