Docker中PySpark连接Oracle遇ORA-12541错误求助

• Docker网络隔离：Docker容器默认拥有独立网络空间，PySpark应用容器内的127.0.0.1指向容器自身，而非Oracle数据库容器，这是触发ORA-12541的核心原因。
• Oracle监听器绑定限制：若listener.ora中监听器仅绑定127.0.0.1，则仅能接收容器内部请求，外部容器无法访问。
• 端口映射/网络配置失效：docker-compose中Oracle端口映射错误，或PySpark与Oracle容器不在同一Docker网络内，导致连接请求无法送达。

1. 修正连接地址（关键步骤） #

将连接字符串中的127.0.0.1替换为Docker网络内Oracle容器的服务名（docker-compose中定义的service名称）或容器IP。

PySpark JDBC示例 #

spark.read.format("jdbc") \
    .option("url", "jdbc:oracle:thin:@//oracle-db:1521/ORCLPDB1") \
    .option("dbtable", "YOUR_TABLE_NAME") \
    .option("user", "DB_USER") \
    .option("password", "DB_PASS") \
    .option("driver", "oracle.jdbc.OracleDriver") \
    .load()

oracledb库示例 #

import oracledb
conn = oracledb.connect(
    user="DB_USER",
    password="DB_PASS",
    dsn="oracle-db:1521/ORCLPDB1"
)

2. 调整Oracle监听器配置 #

修改listener.ora，将监听器绑定到0.0.0.0（允许所有IP访问）：

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 0.0.0.0)(PORT = 1521))
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
    )
  )

重启监听器生效：

lsnrctl stop
lsnrctl start

3. 验证Docker网络配置 #

确保PySpark与Oracle容器处于同一Docker网络（docker-compose默认会创建专属网络），示例docker-compose.yml配置：

version: '3.8'
services:
  oracle-db:
    image: oracle/database:19.3.0-ee
    environment:
      - ORACLE_PWD=your_password
      - ORACLE_CHARACTERSET=AL32UTF8
    ports:
      - "1521:1521"
    networks:
      - app-network
    healthcheck:
      test: ["CMD-SHELL", "echo 'SELECT 1 FROM DUAL;' | sqlplus -s DB_USER/DB_PASS@localhost:1521/ORCLPDB1"]
      interval: 30s
      timeout: 10s
      retries: 5
  pyspark-app:
    build: .
    depends_on:
      - oracle-db
    networks:
      - app-network
networks:
  app-network:
    driver: bridge

注：healthcheck用于确保Oracle服务完全就绪后再启动PySpark应用，避免因数据库未初始化导致连接失败。

listener.ora：Oracle监听器核心配置 #

• LISTENER节点：定义监听器名称与监听规则，HOST=0.0.0.0表示监听所有网卡IP，PORT=1521为Oracle默认端口，PROTOCOL=TCP用于远程网络连接，IPC协议仅用于容器内部进程通信。
• 作用：负责接收客户端连接请求，并转发至对应的Oracle数据库实例。

tnsnames.ora：网络服务名映射配置 #

将易记的服务名映射为具体数据库连接信息，示例：

ORCLPDB1 =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracle-db)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = ORCLPDB1)
    )
  )

• ORCLPDB1：自定义服务名，客户端可直接通过该名称发起连接。
• ADDRESS：指定数据库所在主机（或Docker服务名）与端口。
• SERVICE_NAME：Oracle数据库的服务名（多租户环境下通常为PDB名称），需与数据库实例配置一致，区别于实例SID。

内容的提问来源于stack exchange，提问作者Andrés Tello Urrea