使用Sql*Plus连接Oracle 12.2.0.1 Docker镜像报ORA-12154错误求助

1. 修正容器启动参数添加端口映射 #

你当前的启动命令未将Oracle的服务端口暴露到宿主机，外部客户端无法建立连接，先停止并删除现有容器，使用以下命令重新启动：

docker stop <Oracle-DB>
docker rm <Oracle-DB>
docker run -d -it --name <Oracle-DB> -p 1521:1521 -p 5500:5500 store/oracle/database-enterprise:12.2.0.1

-p参数将容器内1521端口（Oracle服务端口）、5500端口（EM控制台端口，可选映射）绑定到宿主机对应端口。

2. 修正tnsnames.ora配置 #

你当前配置中的HOST值为0.0.0.0是错误的：0.0.0.0是服务端监听绑定的地址段，客户端需要填写Docker宿主机的实际IP：

• 若客户端与Docker部署在同一台设备，HOST改为127.0.0.1
• 若客户端在其他设备，HOST改为Docker宿主机的局域网/公网IP

本地访问场景的修正后配置示例：

ORCLCDB =   (DESCRIPTION =     (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))     (CONNECT_DATA =       (SERVER = DEDICATED)       (SERVICE_NAME = ORCLCDB.localdomain)     )   ) 
ORCLPDB1 =   (DESCRIPTION =     (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))     (CONNECT_DATA =       (SERVER = DEDICATED)       (SERVICE_NAME = ORCLPDB1.localdomain)     )   ) 

3. 确认TNS配置路径生效 #

检查本地Oracle客户端的TNS_ADMIN环境变量是否指向tnsnames.ora所在的目录，未配置该变量会导致客户端找不到TNS配置文件，触发ORA-12154报错：

• Windows系统可在cmd执行set TNS_ADMIN查看
• Linux/macOS可执行echo $TNS_ADMIN查看
  确认返回路径和你存放tnsnames.ora、sqlnet.ora的目录一致即可。

4. 验证连接 #

配置完成后重新执行连接命令即可：

sqlplus sys/Oradoc_db1@ORCLCDB as sysdba

如果仍报错，可先用EZCONNECT方式跳过TNS配置验证连通性：

# 本地场景示例，IP替换为实际宿主机IP
sqlplus sys/Oradoc_db1@//127.0.0.1:1521/ORCLCDB.localdomain as sysdba

若EZCONNECT可以连通，说明是TNS配置内容或路径的问题；若EZCONNECT也无法连通，检查容器端口是否正常监听、宿主机防火墙是否放行1521端口。

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