tnsnames.ora文件必须放在Oracle客户端默认搜索路径中，Windows优先检查%ORACLE_HOME%\network\admin，其次%TNS_ADMIN%环境变量指定路径，最后注册表；Linux检查$ORACLE_HOME/network/admin或$TNS_ADMIN，路径错误将导致ORA-12154错误。
tnsnames.ora 文件该放哪？路径错就根本不会被读取
oracle 客户端启动时，只在固定几个位置查找 tnsnames.ora，不是随便放个地方就能生效。windows 下默认搜索顺序是：%oracle_home%\network\admin → %tns_admin% 环境变量指向的路径 → 注册表中 hkey_local_machine\software\oracle\key_<home_name></home_name> 指定的路径。linux 下则是 $oracle_home/network/admin 或 $tns_admin。常见错误是把文件丢在桌面或 bin 目录下，sqlplus user/pass@mydb 会直接报 ora-12154: tns:could not resolve the connect identifier specified。
验证当前实际生效路径的方法：
- 运行
tnsping MYDB，输出第一行会显示 “Used parameter files”，那里就是它真正加载的tnsnames.ora路径 - 或者临时设环境变量强制指定：
set TNS_ADMIN=C:\my_tns（Windows）或export TNS_ADMIN=/opt/oracle/tns（Linux），再测试
tnsnames.ora 条目怎么写？HOST 和 SERVICE_NAME 必须严格匹配服务端
一个典型条目长这样：
MYDB =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.5.100)(PORT = 1521))
(CONNECT_DATA = (SERVICE_NAME = orcl.example.com))
)
关键点不是语法多漂亮，而是三个字段必须和服务器真实配置对得上：
-
HOST建议填 IP 地址，别填域名 —— 很多内网环境没配 DNS，填dbserver就会卡在解析阶段，tnsping MYDB显示 “Attempting to contact...” 后超时 -
PORT默认是 1521，但服务端监听器可能改过，得去服务器上查lsnrctl status输出里的 “Listening Endpoints Summary” -
SERVICE_NAME不等于 SID。比如服务器init.ora里db_name=orcl，但监听器注册的服务名可能是orcl.example.com或orclXDB，必须和lsnrctl services列出的 “Service "xxx" has 1 instance(s)” 里的名字完全一致
为什么 tnsping 通了，sqlplus 还连不上？检查 sqlnet.ora 的命名方法
tnsping 只验证网络层和 tnsnames.ora 解析，不走认证也不触发连接数据。如果 tnsping MYDB 返回 “OK”，但 sqlplus user/pass@MYDB 报 ORA-12514: TNS:listener does not currently know of service requested，大概率是 sqlnet.ora 里配置了错误的命名方法。
打开 sqlnet.ora，确认这行存在且未被注释：
NAMES.DIRECTORY_PATH= (TNSNAMES, EZCONNECT)
如果里面只有 (EZCONNECT)，那 @MYDB 这种写法会被忽略，客户端压根不查 tnsnames.ora。另外，某些旧环境可能加了 SQLNET.AUTHENTICATION_SERVICES = (NTS)，在非 Windows 域环境会导致认证失败，可临时注释掉再试。
修改后不生效？Oracle 客户端有缓存，别信“改完就立刻好”
Oracle 客户端不会实时重读 tnsnames.ora。常见表现是：改完文件，tnsping MYDB 仍报老错误，甚至重启命令行也无效。
- 最简单办法：关掉所有已打开的
sqlplus、PL/SQL Developer、Toad 等工具，再新开一个终端重试 - 更彻底的办法：删掉
%ORACLE_HOME%\network\admin\caching目录（Windows）或$ORACLE_HOME/network/admin/caching（Linux），这个目录是 Oracle 自动缓存解析结果的地方 - 极端情况：杀掉系统里所有
oracle或tnslsnr相关进程（注意别误杀服务端监听器），再重试
真正容易被忽略的是：很多团队共用一套客户端安装包，tnsnames.ora 改了但没同步到所有开发机，或者 CI 构建机用的是 Docker 镜像里内置的老配置 —— 连接问题往往不是配置不对，而是你改的那份根本没被用上。
