ora-12154是客户端tns名称解析失败，非网络或数据库问题；根本原因是客户端未找到或未正确解析服务名（如orcl），需检查tnsnames.ora路径（tns_admin）、语法、sqlnet.ora中names.directory_path是否启用tnsnames，以及easy connect格式是否合规。
ORA-12154 不是数据库或网络不通的问题，而是客户端根本没找到或没看懂你写的那个服务名（比如 orcl、mydb）。它卡在“解析”这一步，连发包都还没开始。
tnsping 能通但 PL/SQL 还报 ORA-12154？先盯死 tnsnames.ora 文件位置
很多人以为 tnsnames.ora 在 Oracle 安装目录里就自动生效，其实不是。客户端只认 TNS_ADMIN 环境变量指定的路径，或者默认去 $ORACLE_HOME/network/admin 找——但如果你用的是 Instant Client，$ORACLE_HOME 可能压根没设，它就直接跳过。
- 运行
echo $TNS_ADMIN（Linux/macOS）或echo %TNS_ADMIN%（Windows），确认输出是一个真实存在的、含tnsnames.ora的目录 - 如果为空，手动设置：Linux/macOS 执行
export TNS_ADMIN=/path/to/your/tns/dir；Windows 在系统属性 → 环境变量里新增 - 别把文件放错地方：Instant Client 用户必须自己建
NETWORK\ADMIN子目录，并把tnsnames.ora放进去 - 文件名必须全小写（
tnsnames.ora），不能是TnsNames.ora或带空格
服务名拼对了，但还是 ORA-12154？检查 sqlnet.ora 里的 NAMES.DIRECTORY_PATH
即使 tnsnames.ora 存在且路径正确，Oracle 客户端也可能“故意忽略”它——因为 sqlnet.ora 里关掉了 tnsnames 解析方式。
- 打开
sqlnet.ora（也在TNS_ADMIN目录下），找这一行：NAMES.DIRECTORY_PATH - 如果值是
(EZCONNECT)或(LDAP)，删掉tnsnames就必然失败；必须至少包含tnsnames，例如：NAMES.DIRECTORY_PATH = (tnsnames, ezconnect) - 如果整行被注释（开头是
#或!），那就等于没配置，默认值通常是(tnsnames, onames, hostname)，此时可不改 - 改完保存，不用重启任何服务，下次连接立即生效
用 Easy Connect（host:port/service_name）也报 ORA-12154？说明解析链被截断
Easy Connect 不依赖 tnsnames.ora，但它依赖 sqlnet.ora 中启用 ezconnect，且格式必须严格：
- 正确格式只有两种：
host:port/service_name（推荐）或//host:port/service_name；host/port/service_name或host:service_name都会触发 ORA-12154 - 确保
sqlnet.ora中NAMES.DIRECTORY_PATH包含ezconnect（大小写不敏感，但建议小写） - Windows 上若同时装了多个 Oracle 客户端（比如 OraClient12c 和 Instant Client），环境变量
PATH顺序错了，可能调用了旧版本的oci.dll，导致解析逻辑不一致 - 在命令行用
sqlplus /nolog→conn user/pass@192.168.1.10:1521/orcl单独测试，排除 PL/SQL Developer 自身缓存干扰
OAC、Docker、JDBC 等非传统客户端遇到 ORA-12154？绕开 TNS 解析更可靠
云环境（如 Oracle Analytics Cloud）、容器或 Java 应用往往不提供修改 tnsnames.ora 的权限，硬配 TNS 反而增加故障点。
- OAC、Tableau、Power BI 等工具：直接使用完整连接描述符（
DESCRIPTION字符串），而不是服务名。例如：(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=mydb.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl))) - JDBC 连接字符串：用
jdbc:oracle:thin:@//host:port/service_name（注意双斜杠），不要用@host:port:SID（那是旧版 OCI 模式） - Docker 容器内：挂载自定义
tnsnames.ora到/opt/oracle/instantclient_21_1/network/admin/，并设TNS_ADMIN=/opt/oracle/instantclient_21_1/network/admin - 最简验证法：用
tnsping测试服务名，用nc -zv host 1521测试端口通不通——这两步分开做，才能分清是解析失败，还是连接失败
真正容易被忽略的点是：tnsnames.ora 里服务名条目开头不能有空格或制表符，括号必须成对，等号前后不能有多余空格——看着像对的，复制粘贴时却常混入不可见字符。用 cat -A tnsnames.ora（Linux/macOS）或 Notepad++ 的“显示所有字符”功能检查最稳妥。
