Docker容器内无法连接远程Oracle数据库问题求助

架构老林

2026-8-23

排查Docker容器内连接远程Oracle报ORA-12154的问题

一、验证容器与数据库的网络连通性

进入容器：

docker exec -it <你的容器名或ID> bash

ping数据库服务器IP，确认网络可达：
```
ping <数据库服务器IP>
```
用telnet测试1521端口是否开放：
```
telnet <数据库服务器IP> 1521
```
如果这两步失败，说明容器网络存在问题——即使设置了network_mode: host，也可能是主机防火墙/安全组限制，或者容器的host网络配置异常。

二、检查容器内的域名解析

主机能解析DBNAME不代表容器能解析，在容器内执行：

nslookup DBNAME

如果解析不到正确的数据库IP，可通过以下方式解决：

方法1：在docker-compose中添加extra_hosts，手动映射域名和IP：
```
extra_hosts:
  - "DBNAME:<数据库服务器IP>"
```
方法2：在docker-compose里指定与主机相同的DNS服务器：
```
dns:
  - <主机使用的DNS服务器IP>
```

三、验证DSN格式与正确性

你的DSN是DBNAME:1521/XXX，其中XXX是数据库的服务名（SERVICE_NAME），确认主机连接时用的是同样的服务名，无拼写错误。
可暂时用IP替换域名，用完整的Easy Connect字符串测试，排除解析问题：
```
dsn = '//<数据库服务器IP>:1521/XXX'
```

四、调整Oracle客户端模式测试

当前你使用的是依赖本地客户端库的thick模式，可切换到thin模式排查是否是客户端配置问题：
注释掉初始化客户端的代码即可：

import oracledb
# io = '/usr/lib/oracle/21/client64/lib'
# oracledb.init_oracle_client(lib_dir=io)
dsn = 'DBNAME:1521/XXX'
connection = oracledb.connect(
        user="my_user",
        password="my_pwd",
        dsn=dsn
    )

thin模式无需本地客户端库，能快速定位问题根源。