navicat连接oracle报“oracle library is not loaded”本质是未找到匹配的oci库:必须填绝对路径指向真实oci.dll(windows)或libclntsh.so(linux/macos),确保位数一致、路径无中文空格、依赖文件齐全,并重启生效。

OCI library (oci.dll) 路径必须填绝对路径,且指向实际存在的文件
Navicat 不会自动扫描目录或解析相对路径,oci.dll 输入框里填的必须是带盘符、完整到文件名的绝对路径,比如 D:\oracle\instantclient_19_8\oci.dll。只填目录(如 D:\oracle\instantclient_19_8)或用点号开头(如 .\oci.dll)都会静默失败。
常见错误现象:点击“测试连接”前,界面看起来一切正常;但一点击就弹出“Oracle library is not loaded”,甚至刚点开 OCI 设置页,输入框里原本填好的路径又变空了——这往往说明 Navicat 读取该路径时发现文件不存在或权限异常,于是自动清空。
- 确认该路径下确实存在
oci.dll,同时检查是否还有oraociei19.dll(或对应版本号的oraocieiXX.dll),缺一个都可能加载失败 - 路径中不能含中文、空格、括号或特殊符号(如
D:\我的工具\instantclient或C:\Program Files\...都不行) - 修改后必须关闭并重启 Navicat,仅点“确定”不生效
位数必须严格匹配:64位 Navicat 只能配 64位 Instant Client
这是最常被忽略的硬性前提。32 位客户端在 64 位 Navicat 中根本无法加载,哪怕路径完全正确,也会报 Connot load OCI DLL,87:Instant Client package is required for Basic and TNS connetion.,且配置框会自动清空。
判断方式很简单:右键 Navicat 快捷方式 → 属性 → 详细信息 → 查看“平台”字段;再核对 Instant Client 下载页的标注(如 instantclient-basic-windows.x64-19.22.0.0.0dbru.zip 中的 x64)。
- Windows 上可通过
taskmgr查看 Navicat 进程名是否带 *32 后缀(带则为 32 位) - Oracle 官网下载页明确区分 x86-64 和 x86 版本,别只看“19c”就直接下
- macOS Apple Silicon(M1/M2/M3)必须用 ARM64 版 Instant Client,x86_64 模拟运行时 OCI 加载必然失败
Linux/macOS 不走 GUI 配置,得靠环境变量指定 libclntsh.so
Navicat for Linux/macOS 压根不读取“工具→选项→OCI”里的设置,那个界面只是摆设。真正起作用的是系统级环境变量。
典型错误:在 macOS 上照 Windows 步骤填了 oci.dll 路径,点确定、重启,依然报错——因为 macOS 根本不用 .dll,它要找的是 libclntsh.dylib(或 .so),而且只认 DYLD_LIBRARY_PATH 或 LIBRARY_PATH。
- macOS(Intel 或 Apple Silicon):启动终端,执行
export DYLD_LIBRARY_PATH=/opt/oracle/instantclient:$DYLD_LIBRARY_PATH,然后从该终端启动 Navicat(如open -a "Navicat Premium") - Linux:设
LD_LIBRARY_PATH=/opt/oracle/instantclient,同样需从该 shell 启动 Navicat - 确保该目录下有
libclntsh.so和libnnz.so,少一个就加载失败
Oracle 19c+ 连接失败,大概率是客户端版本太旧
从 Oracle 12c 开始,服务端默认禁用旧协议;19c 更进一步收紧认证要求。用 11g 或 12c 的 Instant Client 连 19c,即使 OCI 加载成功,也会卡在登录阶段,报 ORA-28040: No matching authentication protocol 或 no matching authentication protocol。
这不是 Navicat 的问题,是 Oracle 服务端拒绝与低版本客户端握手。此时“测试连接”可能显示成功,但执行查询时立即报错,或者连登录框都打不开。
- 优先下载与目标数据库主版本一致的 Instant Client,例如连 Oracle 19c 就用
instantclient-basic-19_22 - 若必须兼容多版本,可尝试在 Navicat 连接配置的“高级”选项卡中勾选
Enable Oracle Wallet或调整Authentication类型,但不如升级客户端直接 - 不要复用 PL/SQL Developer 自带的绿色版 client——实测多数存在版本错配或精简缺失,不可靠











