ORA-12154本质是Navicat未加载到tnsnames.ora中的服务名，主因包括TNS_ADMIN环境变量未设或错误、Instant Client位数与Navicat不匹配、tnsnames.ora路径/格式/编码问题（如BOM、空格、括号不全）、连接类型选错（TNS模式下填的“连接名”必须严格对应tnsnames.ora中服务名别名）。
tnsnames.ora 文件没被 Navicat 读到
ora-12154 的本质是客户端压根没加载到你写的那个服务名，不是配错了，而是根本没看见。navicat 不自己解析 tnsnames.ora，它依赖 oracle 客户端（比如 instant client）去读——而客户端只会在特定路径下找这个文件。
常见陷阱：
-
TNS_ADMIN环境变量没设，或指向了空目录、错误目录 - 装了多个 Oracle 客户端（比如 11g 和 19c），
TNS_ADMIN指向了旧版本的network/admin，但你改的是新路径下的文件 - Navicat 是 32 位，却配了 64 位 Instant Client（或反过来），导致调用的 OCI 库完全不读你设的路径
- Windows 下用记事本编辑过
tnsnames.ora，保存时加了 BOM 或用了中文全角空格，Oracle 解析器直接跳过整行
验证方法：在命令行运行 tnsping ORCL（把 ORCL 换成你要连的服务名），看第一行输出：Used parameter files: 后面的路径，就是它实际读的文件位置。如果为空，说明没找到任何 tnsnames.ora。
tnsnames.ora 里服务名拼写/格式不合法
这个文件看着像配置，实则是 Oracle 自己的弱语法解析器在读。大小写、括号、空格、换行都可能让整个条目失效。
典型问题：
- 别名后多了一个空格：
ORCL =✅，ORCL =❌（末尾有不可见空格） - 括号不匹配：漏掉最外层
)，或多写一个(，哪怕只差一个字符，tnsping就报TNS-03505 -
HOST写成host或Host：文档说不区分，但某些旧版 Instant Client（如 11.2.0.4）会卡住 -
SERVICE_NAME值带了多余点或分号：SERVICE_NAME = orclpdb.（末尾点）或SERVICE_NAME = orclpdb;（分号） - 用了
//或#在行中写注释，必须独占一行且以#开头
最小可用模板（复制粘贴前请删掉中文括号）：
ORCL =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orclpdb)
)
)
Navicat 连接设置和服务名不一致
很多人以为填 IP+端口就能绕过 TNS，但在 Navicat 的 Oracle 连接类型里，一旦选了 “Oracle (TNS)”，它就强制走 tnsnames.ora 查服务名——你填的 “连接名” 字段，就是 tnsnames.ora 里那个等号左边的名字，不是数据库名，也不是 SERVICE_NAME。
例如：
-
tnsnames.ora里定义的是MYDB = (DESCRIPTION = ...) - Navicat 中“连接名”必须填
MYDB，不能填orclpdb，也不能填192.168.1.100:1521/orclpdb - 如果想直连，就不要选 “Oracle (TNS)”，改选 “Oracle (Basic)” 类型，然后手动填 Host、Port、Service Name
注意：OIC（Oracle Integration Cloud）这类云环境，通常不建议配本地 tnsnames.ora，优先用 “Basic” 模式 + 完整服务名（含域名和 Wallet 路径）连接。
Instant Client 版本与 Navicat 位数不匹配
这是 Windows 上最隐蔽也最高频的问题。Navicat 安装包明确标着 “x86” 或 “x64”，它启动时加载的 oci.dll 必须和自身位数一致。若不匹配，OCI 初始化失败，tnsnames.ora 根本不会被尝试读取，直接报 ORA-12154。
确认方式：
- 右键 Navicat 快捷方式 → “属性” → “兼容性” → 看是否勾选了 “以兼容模式运行” 或 “以管理员身份运行”（有时会干扰位数判断）
- 任务管理器中看进程名：32 位进程后缀带
*32，如navicat.exe *32 - 下载 Instant Client 时务必核对：Navicat x86 → instantclient-basic-windows.x64.zip ❌，必须用 x86 版
临时验证：把 Instant Client 解压路径加到系统 PATH 最前面，再开命令行运行 sqlplus /@ORCL。如果 sqlplus 能连通，但 Navicat 不行，基本锁定是位数或环境变量隔离问题。
复杂点在于：有些企业环境会预装 Oracle 客户端（比如 PL/SQL Developer 带的），它的 oci.dll 可能被系统 PATH 优先加载，覆盖你为 Navicat 配的路径。这时候不能只靠 TNS_ADMIN，还得确保 PATH 中 Instant Client 的路径排在所有其他 Oracle 目录之前。
