解决！连接Oracle时候出现oracle library is not loaded错误

### 解决Navicat 17 for Mac连接Oracle时提示“Oracle library is not loaded”的方法 在使用 **Navicat 17 for Mac** 连接 Oracle 数据库时，出现 **“Oracle library is not loaded”** 错误，通常是由于缺少 Oracle 的客户端库（OCI）或配置不正确所导致的。以下是详细的解决方法： #### 1. 安装Oracle Instant Client Navicat 依赖 Oracle 提供的 **Instant Client** 来连接 Oracle 数据库。在 Mac 系统中，需要手动下载并配置 Oracle Instant Client。 - 前往 Oracle 官网下载适用于 Mac 的 Instant Client： - [Oracle Instant Client Downloads](https://www.oracle.com/database/technologies/instant-client/macos-intel-x86-downloads.html) - 下载 **Basic Package**（例如 `instantclient-basic-macos.x64-*.zip`）。 - 解压下载的压缩包，将解压后的文件夹（如 `instantclient_21_10`）移动到 `/opt/oracle/` 目录下。 #### 2. 配置环境变量 Mac 系统需要设置环境变量以确保 Navicat 能正确找到 OCI 库。 - 打开终端，编辑环境变量配置文件（如 `.bash_profile` 或 `.zshrc`，取决于你的 shell 类型）： ```bash nano ~/.bash_profile ``` - 添加以下内容（根据实际路径调整）： ```bash export ORACLE_HOME=/opt/oracle/instantclient_21_10 export DYLD_LIBRARY_PATH=$ORACLE_HOME export PATH=$ORACLE_HOME:$PATH ``` - 保存并退出，然后运行： ```bash source ~/.bash_profile ``` #### 3. 配置Navicat的OCI环境 在 Navicat 中指定 Oracle 客户端库的路径： - 打开 Navicat 17 for Mac。 - 点击顶部菜单栏的 **“工具” > “选项” > “环境” > “OCI环境”**。 - 在 “OCI library” 字段中，输入 `libclntsh.dylib` 文件的完整路径，例如： ``` /opt/oracle/instantclient_21_10/libclntsh.dylib ``` - 点击确认并重启 Navicat。 #### 4. 检查Navicat与Oracle Instant Client的架构匹配 确保 Navicat 和 Oracle Instant Client 的架构一致，即如果使用的是 **64位 Navicat**，则必须安装 **64位 Oracle Instant Client**。若版本不匹配，也会导致“Oracle library is not loaded”错误[^4]。 #### 5. 验证连接 重新打开 Navicat，尝试建立新的 Oracle 连接并点击 **“测试连接”** 按钮，确认是否成功连接数据库。 ---