tnsnames.ora路径错误或语法不规范会导致ORA-12154错误；优先检查TNS_ADMIN环境变量，用tnsping验证实际读取路径；等号无空格、括号闭合、换行正确是语法关键；多租户下SERVICE_NAME须与PDB名严格一致。
tnsnames.ora 文件路径找不对，TNS 名称根本不会被读到
oracle 客户端默认只在几个固定位置查找 tnsnames.ora，不是你随便放个地方它就认。常见错误是把文件丢在项目目录、桌面或 oracle 安装根目录下，结果 sqlplus user/pass@mydb 一直报 ora-12154: tns:could not resolve the connect identifier specified。
实际生效路径优先级（从高到低）：
-
TNS_ADMIN环境变量指向的目录（最高优先级，建议优先用） - Windows：注册表
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_<i>ORACLE_HOME_NAME</i>下的TNS_ADMIN值 - Unix/Linux：
$ORACLE_HOME/network/admin - Windows：
%ORACLE_HOME%\network\admin
验证当前生效路径最直接的方法是运行：
tnsping MYDB
，输出里第一行会明确写 “Used parameter files” —— 那就是它真正在读的文件路径。
tnsnames.ora 语法格式错一个空格，TNS 就不认
这个文件对格式极其敏感：等号前后不能有空格，别名后必须跟左括号，每个子句结尾必须有换行和右括号，注释只能用 # 开头且不能出现在行中。
典型错误写法（以下任一都会导致解析失败）：
MYDB = # 这里等号前/后有空格 → 失败<br> (DESCRIPTION =<br> (ADDRESS = (PROTOCOL = TCP)(HOST = db.example.com)(PORT = 1521))<br> (CONNECT_DATA = (SERVICE_NAME = orcl))<br> )# 缺少换行或右括号 → 失败
正确写法（严格对齐、无多余空格、括号闭合）：
MYDB =<br> (DESCRIPTION =<br> (ADDRESS = (PROTOCOL = TCP)(HOST = db.example.com)(PORT = 1521))<br> (CONNECT_DATA = (SERVICE_NAME = orcl))<br> )
注意：MYDB 是别名，大小写不敏感；但 SERVICE_NAME 和 HOST 值区分大小写（尤其 SERVICE_NAME 在 12c+ 中常为小写 orclpdb1）。
tnsping 能通不代表应用能连，得看客户端用的是哪个 Oracle Home
你在命令行跑 tnsping MYDB 成功，但 Java 应用或 PL/SQL Developer 死活连不上，大概率是它们加载了另一个 Oracle Client 或 Instant Client —— 对应的 TNS_ADMIN 或 network/admin 路径完全不同。
排查方法：
- Java 应用：检查
java -Doracle.net.tns_admin=...是否显式指定，或确认其 classpath 中 ojdbc.jar 所属的 Oracle Home - PL/SQL Developer：菜单 Tools → Preferences → Oracle → Connection 里看 “Oracle Home” 和 “TNS File” 设置
- PowerShell / CMD 中执行
echo %ORACLE_HOME%和echo %TNS_ADMIN%，对比应用启动时的环境变量
不同工具可能共用一个 tnsnames.ora，也可能各自维护一份 —— 别默认“我改了就全好了”。
Oracle 12c+ 使用 PDB 时，SERVICE_NAME 必须匹配实际 PDB 名
如果数据库启用了多租户（CDB/PDB），而你仍沿用老习惯写 (SERVICE_NAME = orcl)，但实际 PDB 名是 orclpdb1，那连接就会静默失败（tnsping 可能显示 OK，但 sqlplus 登录时报 ORA-12514）。
查真实 SERVICE_NAME 的方式：
- 登录数据库后执行：
SELECT name, pdb FROM v$services;
- 或用
lsnrctl status查监听器注册的服务名列表
务必确保 tnsnames.ora 中 SERVICE_NAME 的值和查询结果完全一致（包括大小写和下划线），CDB root 的 service 通常叫 CDB$ROOT，PDB 的才带具体名字。
别漏掉监听器是否真正注册了该服务 —— 即使配置全对，监听没 reload 或 PDB 没 open，照样连不上。
