Navicat找不到tnsnames.ora的根本原因是TNS_ADMIN环境变量未设置、路径错误或未被继承；需设为绝对路径（不含中文、空格、BOM，末尾无反斜杠），并重启Navicat，或在连接高级设置中手动指定tnsnames.ora文件。
Navicat找不到tnsnames.ora：TNS_ADMIN没生效
navicat 报 ora-12154: tns could not resolve the connect identifier specified，不是服务名写错了，而是它压根没读到 tnsnames.ora 文件。根本原因常是 tns_admin 环境变量未设置、指向错误路径，或 navicat 没继承该变量。
Windows 下，即使你把 tnsnames.ora 放在 %ORACLE_HOME%\network\admin\，Navicat 也不一定认——它只看 TNS_ADMIN 指向的目录，且不自动 fallback 到 ORACLE_HOME。
-
TNS_ADMIN必须是**绝对路径**，不能含中文、空格或环境变量占位符（如%USERPROFILE%） - 路径末尾**不要加反斜杠**（
C:\oracle\client\network\admin\❌ →C:\oracle\client\network\admin✅） - 确认该目录下确实存在
tnsnames.ora，且文件编码为 ANSI 或 UTF-8 无 BOM（BOM 会导致解析失败） - 修改后必须**重启 Navicat**（不是重连，是彻底关闭再打开），否则环境变量不生效
Navicat用了Instant Client但TNS_ADMIN被忽略
Navicat 自带精简版 Instant Client，此时它默认不读系统级 TNS_ADMIN，而是依赖自身 OCI 配置路径。即使你设置了全局 TNS_ADMIN，Navicat 也可能视而不见。
解决方法是绕过环境变量，直接在 Navicat 内指定：
- 连接设置 → 「高级」选项卡 → 勾选「使用 TNS 名称文件」
- 点击右侧「浏览」，**手动选中你的
tnsnames.ora文件**（不是目录） - 确保该文件里服务名（等号左边）与你在 Navicat「服务名」字段填的**完全一致、大小写敏感**
例如：文件里写的是 ORCL21 = (DESCRIPTION = ...)，你就必须填 ORCL21，填 orcl21 或 Orcl21 都会触发 ORA-12154。
tnsnames.ora内容正确但依然报错：HOST地址写死了
很多人复制了服务器上的 tnsnames.ora 到本地，却没改其中的 HOST 字段。比如条目里写的是 HOST = localhost 或 HOST = 127.0.0.1，Navicat 就会尝试连自己本机，而不是远程 Oracle 21c 服务器。
检查你 tnsnames.ora 中对应服务名的 HOST 值：
- 必须是 Oracle 服务器的**局域网 IP**（如
192.168.1.100），不能是localhost、127.0.0.1或主机名（除非本地hosts已映射） -
PORT必须与监听器实际监听端口一致（Oracle 21c 默认仍是1521） -
SERVICE_NAME要和lsnrctl status输出里的Service "xxx"完全匹配，不是 SID（尤其 21c 多租户环境下，用SERVICE_NAME才能连 PDB）
验证TNS配置是否真正就绪：别跳过tnsping
光看 Navicat 报错没用。最直接的验证方式是用命令行跑 tnsping ——它能明确告诉你解析阶段卡在哪。
打开终端（Windows 用 CMD，确保已配置好 Oracle Client 的 PATH），执行：
tnsping ORCL21
如果返回 OK (20 msec)，说明 TNS_ADMIN、tnsnames.ora 路径、服务名拼写、HOST/PORT 全部正确；如果返回 TNS-03505: Failed to resolve name，就是解析失败，得回头查前三个环节。
注意：tnsping 只验证名称解析和网络可达性，不校验用户名密码。它通了，Navicat 还连不上，问题就出在认证或监听器服务注册层面（比如 ORA-12514），那就不是 TNS_ADMIN 的事了。
