根本原因是macOS未正确加载OCI库:需确认Navicat以Rosetta(Intel模式)运行、手动指定libclntsh.dylib绝对路径、清除quarantine属性,且必须使用Basic版(非Lite)Instant Client。
navicat 在 macos(尤其是 apple silicon)上提示“oracle library is not loaded”或“cannot create oci environment”,根本原因几乎总是 oci.dll(macos 实际是 libclntsh.dylib)没被正确加载,而不是真的缺文件——路径错、架构不匹配、权限被隔离,三者占 95% 以上。
确认 Navicat 是否在用 Rosetta 运行(M 芯片必查)
Apple Silicon Mac 上,Navicat 必须以 Intel 架构运行才能加载 Oracle Instant Client(目前所有官方 Instant Client 都是 x86_64,无原生 arm64 版本)。即使你勾选了“使用 Rosetta”,也得验证进程真正在 Rosetta 下跑:
- 打开「活动监视器」→ 搜索
Navicat→ 看「架构」列是否显示Intel - 若显示
Apple,右键 Navicat 应用 → 「显示简介」→ 勾选「使用 Rosetta 打开」→ 完全退出再重开 - 不勾选「使用捆绑的 instant client」,否则 Navicat 会强行加载它自带的、已 quarantined 的旧版库,直接报错
手动指定 OCI 路径时,必须用完整 dylib 文件路径(不是文件夹)
macOS 下 Navicat 要求的不是目录,而是具体到 libclntsh.dylib 的绝对路径。填错路径或填成文件夹都会静默失败:
- 下载 Oracle Instant Client Basic(推荐 19.23 或 21.10,必须 x86_64 版本),解压后找到
libclntsh.dylib(通常在根目录或lib/子目录下) - 在 Navicat 中:Navicat →「设置」→「环境」→ 取消勾选「使用捆绑的 instant client」→ 在「OCI library」栏粘贴完整路径,例如:
/Users/you/instantclient_19_23/libclntsh.dylib -
sqlplus路径可留空(非必需),但若填了,必须指向同版本 Instant Client 解压目录下的sqlplus可执行文件 - 路径中不能有中文、空格或符号链接;建议放在用户主目录下,避免 SIP 权限拦截
解决 macOS 对下载库的 quarantine 隔离问题
macOS 会自动给从网络下载的 dylib 打上 com.apple.quarantine 属性,导致 Navicat 加载失败,现象是“测试连接”无反应或闪退:
- 终端执行:
xattr -d com.apple.quarantine /path/to/libclntsh.dylib - 如果整个 Instant Client 文件夹都被隔离,对文件夹递归执行:
xattr -rd com.apple.quarantine /path/to/instantclient_19_23 - 执行后可加
ls -l@确认属性已清除 - 这步不做,哪怕路径对、架构对,也会卡在“无法创建 OCI 环境”
字符集报错 ORA-12737 说明 Instant Client 版本太轻量
报 ORA-12737: Instant Client Light: unsupported server character set ZHS16GBK,意味着你用了 Basic Lite 版本,它砍掉了中文等多字节字符集支持:
- 必须下载「Basic」包(不是 Basic Lite),官网明确标注为
Instant Client Basic - 解压后检查是否存在
orannzsbb19.dylib(对应版本号)或orazz12.dylib—— 这是字符集支持模块,Lite 版没有 - 若仍报错,临时在 Navicat 连接配置里把「字符集」手动设为
ZHS16GBK(与服务端一致),避免自动探测失败
最易被忽略的是 quarantine 属性和 Rosetta 进程架构——两者都无声无息,不报具体错误,只让连接一直卡在“环境创建失败”。先验这两点,比反复换版本、改路径更省时间。


















