Docker容器Oracle数据库可被SQL Developer连接但应用无法连接求助

问题背景 #

通过以下步骤部署Oracle数据库后，出现本机应用连接失败的异常：

1. 拉取Oracle镜像：docker pull container-registry.oracle.com/database/enterprise:latest
2. 启动容器并通过sqlplus创建用户：

CREATE USER c##test IDENTIFIED BY admin;
GRANT CONNECT TO c##test;
GRANT CONNECT, RESOURCE, DBA TO c##test;
GRANT UNLIMITED TABLESPACE TO c##test;

3. 现象：其他机器用SQL Developer可正常连接c##test用户，但本机应用连接报错：

testing Database connection ...java.sql.SQLException: ORA-12541: Cannot connect. No listener at host 191.168.1.8 port 1521. (CONNECTION_ID=29wHZEPHSF6VUoD7R+VIUw==)

可能原因及解决方法 #

1. 本机端口或防火墙拦截 #

• 检查端口占用：
  • Linux执行：ss -tulpn | grep 1521，Windows执行：netstat -ano | findstr :1521，确认1521端口未被其他进程占用。若有占用，停止对应进程或调整Oracle监听端口。
• 检查防火墙规则：
  • Linux执行：sudo iptables -L -n | grep 1521，若无允许规则，添加：sudo iptables -A INPUT -p tcp --dport 1521 -j ACCEPT
  • Windows在防火墙高级设置中，添加入站规则允许1521端口的TCP连接。

2. Docker端口映射配置错误 #

• 确认容器启动时的端口映射：
  启动容器必须包含端口映射参数，示例命令：

  docker run -d -p 1521:1521 --name oracle-db container-registry.oracle.com/database/enterprise:latest
  

• 验证映射状态：
  执行docker inspect oracle-db | grep -A 10 "Ports"，确认1521/tcp对应主机端口为0.0.0.0:1521或指定IP191.168.1.8:1521。若之前未配置映射，需备份数据后重新启动容器并添加-p 1521:1521参数。

3. Oracle监听绑定范围受限 #

• 进入容器检查监听状态：

  docker exec -it oracle-db bash
  lsnrctl status
  

  确认监听状态为READY，且监听地址包含0.0.0.0或容器IP，而非仅localhost。
• 修改监听配置：
  编辑容器内$ORACLE_HOME/network/admin/listener.ora，将LISTENER的ADDRESS改为：

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

  重启监听：lsnrctl stop && lsnrctl start

4. 本机连接字符串地址问题 #

• 尝试将连接字符串中的191.168.1.8替换为localhost或127.0.0.1测试，确认是否因多网卡导致地址解析异常。
• 若本机存在多网卡，启动容器时可指定绑定的主机IP：

  docker run -d -p 191.168.1.8:1521:1521 --name oracle-db container-registry.oracle.com/database/enterprise:latest
  

5. 本地TNS配置错误 #

• 若应用使用TNS连接，检查本机tnsnames.ora配置，确保地址指向正确的主机IP和端口，服务名与容器内一致：

  ORCL =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 191.168.1.8)(PORT = 1521))
      (CONNECT_DATA =
        (SERVER = DEDICATED)
        (SERVICE_NAME = ORCLCDB)
      )
    )
  

  容器内服务名可通过sqlplus / as sysdba执行show parameter service_name查看。

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