ORA-12154错误本质是Navicat无法解析服务名别名，需确保“服务名”字段严格填写tnsnames.ora中定义的大小写敏感别名（如ORCLPDB1），并手动指定TNS Admin路径、验证tnsping连通性，或改用Basic连接模式绕过TNS解析。
ora-12154 不是连不上数据库，而是 navicat 根本没开始连——它连“服务名该去哪找”这一步都失败了。问题 100% 出在客户端本地配置链上，和监听器是否运行、网络是否通、密码是否对完全无关。
Navicat 连接界面填的服务名，到底该写什么？
你填的不是 IP、不是域名、不是 SID（除非明确要求）、更不是数据库名。它必须是 tnsnames.ora 文件里定义的那个**别名（alias）**，且大小写严格一致。
- 比如
tnsnames.ora里有这一段：ORCLPDB1 =\n (DESCRIPTION =\n (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))\n (CONNECT_DATA =\n (SERVER = DEDICATED)\n (SERVICE_NAME = orclpdb1.example.com)\n )\n )
那么 Navicat “服务名”字段必须填ORCLPDB1，不能填orclpdb1、orclpdb1.example.com或192.168.1.100 - Oracle 12c+ 默认区分大小写；全角空格、中文冒号、换行截断
=都会导致整段失效 - 别名 ≠
SERVICE_NAME，也 ≠SID，它是你在本地文件里“起的绰号”
tnsnames.ora 文件到底被 Navicat 读到了吗？
Navicat 不认系统级 TNS_ADMIN 环境变量，也不自动扫描 %ORACLE_HOME%\network\admin。它只看你手动指定的路径，或内置 Instant Client 的默认位置。
- 打开 Navicat → 工具 → 选项 → 环境 → Oracle → 检查 “Oracle Home” 是否指向含
network\admin\tnsnames.ora的目录（例如C:\oracle\instantclient_21_12） - 勾选 “使用 TNS 名称”，并在“TNS Admin”栏**手动输入完整目录路径**（不是文件路径！结尾不能带
\tnsnames.ora） - 用命令行验证：在终端执行
tnsping ORCLPDB1，若返回TNS-03505: Failed to resolve name，说明 Navicat 和命令行都没读到文件——先解决这个 - Windows 下记事本保存的
tnsnames.ora极易带 BOM 头，改用 VS Code 或 Notepad++ 以 UTF-8 无 BOM 保存
绕过 tnsnames.ora 的最简方案是什么？
如果你只是想连上，不是非得走 TNS 解析，直接用 Easy Connect 格式，不依赖任何配置文件。
- Navicat 连接类型选 “Oracle (Basic)”（不是 TNS）
- 主机填
192.168.1.100，端口填1521，服务名填orclpdb1.example.com（即监听器实际注册的SERVICE_NAME） - 或者更稳妥：把“服务名”字段留空，直接在“SID”字段填完整连接串
//192.168.1.100:1521/orclpdb1.example.com（注意双斜杠） - 此方式跳过
tnsnames.ora解析，也避开了大小写、路径、BOM 等所有陷阱
真正卡住人的从来不是语法，而是误以为“文件放对位置=被读到”。Navicat 的 OCI 加载路径是封闭的，它不会像 sqlplus 那样 fallback 到多个备选路径——你指定的目录必须存在、可读、且里面真有语法合法的 tnsnames.ora，少一个条件就立即报 ORA-12154。
