navicat的tns功能必须手动指定oci库路径才能启用，否则不加载tnsnames.ora；需填oci.dll或libclntsh.so绝对路径，且tnsnames.ora必须置于其network/admin子目录下，连接类型须选tns并勾选“使用oracle客户端”。
navicat 的 tns 功能根本不会启动，除非你明确告诉它 oci 库在哪——不是“装了 instant client 就自动生效”，而是必须手动指定 oci.dll 或 libclntsh.so 的完整路径。
Navicat 连接 Oracle 时必须手动配置 OCI 路径
Navicat 自身不带 Oracle 网络栈，所有 TNS 解析、连接建立都依赖外部 OCI 库。它不会自动扫描系统 PATH 或猜测客户端位置。即使你已安装 Oracle Instant Client 并设置了 TNS_ADMIN，只要 Navicat 的 OCI 路径没填对，tnsnames.ora 就永远是“空的”。
常见错误现象：
- “TNS configuration is empty” 提示反复出现
- tnsping 能通，但 Navicat 下拉列表仍为空
- OCI 环境设置里显示 “Not loaded” 或路径灰显
实操建议：
- 在 Navicat 主菜单 → 工具 → 选项 → 环境（Windows/macOS）或 Navicat → 设置 → 环境（macOS），找到
OCI library输入框 - 填入的是
oci.dll（Windows）或libclntsh.so（Linux/macOS）的**绝对路径**，例如：C:\oracle\instantclient_21_1\oci.dll或/opt/oracle/instantclient_21_1/libclntsh.so - 不要填目录，也不要填
oci.lib、oraocci.dll等其他文件——只认这个特定文件名 - 路径中不能含中文、空格或特殊符号；若含空格，需确保整个路径被引号包裹（但更稳妥做法是移走空格）
OCI 路径填对了，tnsnames.ora 还是不加载？检查三处硬编码位置
Navicat 加载 tnsnames.ora 不是从 TNS_ADMIN 直接读，而是按固定规则在 OCI 库所在目录下找。它只认两个子路径：network\admin 和 net80\admin（旧版），且文件名必须是 tnsnames.ora（大小写敏感）。
实操建议：
- 确认
tnsnames.ora文件真实存在于oci.dll所在目录的network\admin\子目录下，例如：C:\oracle\instantclient_21_1\network\admin\tnsnames.ora - 如果用的是 macOS/Linux，路径必须是小写：
network/admin/tnsnames.ora，NETWORK/ADMIN不识别 - 不要依赖
TNS_ADMIN环境变量——Navicat 在此场景下基本忽略它；唯一可靠方式是把文件放对位置 - 文件权限要放开：Linux/macOS 下确保当前用户有读权限（
chmod 644 tnsnames.ora）
为什么 tnsping 能通，Navicat 却报 ORA-12154？OCI 版本和位数不匹配
tnsping 是 Oracle 自家工具，它读的是系统级 Oracle Home 或 TNS_ADMIN；而 Navicat 只认你指定的那个 oci.dll 所绑定的环境。两者完全隔离。
典型问题：
- 你在命令行用的是 19c 客户端，tnsping 成功；但 Navicat 指向的是 12c 的
oci.dll，而该版本不支持你的服务名格式（如 PDB service name） - 64 位 Navicat 配了 32 位
oci.dll，加载失败却无提示，表现为“TNS 列表为空” - Instant Client 解压后漏掉了
msvcr120.dll（Windows）或libaio.so（Linux），导致 OCI 初始化静默失败
验证方法：
- Windows：用
Dependency Walker或dumpbin /dependents oci.dll查看是否缺失 DLL - Linux：运行
ldd libclntsh.so | grep "not found" - macOS：用
otool -L libclntsh.dylib检查依赖链
勾选“使用 Oracle 客户端”才是 TNS 生效的前提
很多人填好了 OCI 路径、放对了 tnsnames.ora，但连接类型仍选“Basic”，结果服务名下拉还是空——因为 Navicat 默认走 Easy Connect 模式，压根不读 TNS 文件。
必须操作：
- 新建连接时，连接类型必须选 TNS（不是 Basic 或 SSH）
- 在连接设置的 高级 选项卡中，务必勾选
使用 Oracle 客户端（Use Oracle Client） - 此时“服务名”字段才变成下拉框，且内容来自
tnsnames.ora中的别名（等号左边） - 如果仍为空，说明前三个步骤中至少有一处没到位：OCI 路径错、文件没放对位置、或 OCI 本身加载失败
最易被忽略的一点：OCI 库路径一旦填错，Navicat 不会报错，也不会提示“加载失败”，而是直接跳过 TNS 支持——整个功能静默失效。你得自己去环境设置里核对路径是否存在、文件是否可读、位数是否匹配。
