Oracle客户端在Linux上按优先级读取tnsnames.ora：先查TNS_ADMIN环境变量指定路径，再查$ORACLE_HOME/network/admin；文件必须放在这两类路径下，且语法严格（等号无空格、括号匹配、#注释独占行），否则解析失败。
tnsnames.ora 文件放哪，Oracle 才会读它
Linux 上 Oracle 客户端或数据库实例默认不读你随便建的 tnsnames.ora。它只在固定路径按优先级查找，顺序是：
-
TNS_ADMIN环境变量指向的目录（最高优先级，推荐设这个） -
$ORACLE_HOME/network/admin（最常见 fallback 路径）
别把文件丢在 /home/oracle/、/tmp 或项目根目录下——那些位置 Oracle 根本不会扫描。验证当前生效路径最简单的方法是运行：
tnsping MYDB
输出第一行明确写着 Used parameter files，后面跟的就是它真正在读的完整路径。
tnsnames.ora 语法错一个空格就解析失败
这个文件对格式极其敏感，不是“看着像就行”。常见踩坑点包括：
- 别名后必须紧接
=，等号前后不能有空格：MYDB =❌，MYDB=✅ - 每个
(必须有对应)，且右括号必须独占一行或紧跟在最后一个子句后（无换行会导致解析中断） - 注释只能用
#开头，且不能出现在行中（比如(HOST = db.example.com) # comment❌） -
SERVICE_NAME值区分大小写，12c+ 多租户环境下常为小写（如orclpdb1），写成ORCLPDB1就连不上
正确示例：
MYDB =<br>(DESCRIPTION =<br> (ADDRESS = (PROTOCOL = TCP)(HOST = db.example.com)(PORT = 1521))<br> (CONNECT_DATA = (SERVICE_NAME = orclpdb1))<br>)
tnsping 成功 ≠ 应用能连上
你在终端里 tnsping MYDB 返回 OK，不代表 Java、Python 或 PL/SQL Developer 就能连。原因通常是它们加载了不同的 Oracle Home 或 Instant Client：
- Java 应用可能通过
-Doracle.net.tns_admin=指定了自己的TNS_ADMIN，或依赖 classpath 中ojdbc.jar所属的 Oracle Home - Instant Client 用户必须显式设置
TNS_ADMIN，否则它根本不会去$ORACLE_HOME下找——因为它没有$ORACLE_HOME - 多个 Oracle 安装共存时，
which tnsping和应用实际调用的tnsping可能来自不同版本
排查方法：在应用启动时加日志或调试参数，确认它加载的是哪个 tnsnames.ora；或者直接在应用所在环境里执行 echo $TNS_ADMIN 和 tnsping MYDB 对比。
多租户环境下 SERVICE_NAME 必须严格匹配 PDB 名
如果你连的是 12c 或更高版本的可插拔数据库（PDB），tnsnames.ora 里的 SERVICE_NAME 必须和 PDB 的实际服务名完全一致，包括大小写和下划线。查 PDB 服务名最准的方式是登录 CDB：
sqlplus / as sysdba<br>SELECT name, pdb FROM v$services ORDER BY name;
输出里 PDB 列对应的服务名，就是你要填进 tnsnames.ora 的值。填错成 CDB 名、实例名（ORACLE_SID）或旧的全局数据库名，都会报 ORA-12514: TNS:listener does not currently know of service requested in connect descriptor。
