炙炙牛1. 项目背景与需求分析
作为一名长期在Mac环境下开发Vue应用的全栈工程师，最近接手了一个需要连接Oracle数据库的企业级项目。本以为这会是常规操作，没想到在安装oracledb依赖时遇到了不少坑。经过两天的折腾和反复测试，终于整理出一套完整的解决方案。
Oracle数据库在企业环境中广泛使用，但不同于MySQL或PostgreSQL这类开源数据库，Oracle的Node.js驱动（oracledb）需要依赖Oracle Instant Client才能运行。在Mac系统上，这涉及到本地库的编译和链接，过程比Windows或Linux平台更为复杂。特别是在M1/M2芯片的Mac上，还需要处理ARM架构的兼容性问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具安装
2.1 安装Oracle Instant Client
Oracle Instant Client是连接Oracle数据库的轻量级客户端，不包含完整的Oracle客户端工具。在Mac上推荐使用Homebrew安装：
bash复制brew tap InstantClientTap/instantclient
brew install instantclient-basic
注意：如果你的Mac是M1/M2芯片，需要确认brew是否运行在Rosetta模式下。可以通过
arch -x86_64 brew install命令强制使用x86架构安装。
对于开发调试，建议额外安装SQL*Plus工具包：
bash复制brew install instantclient-sqlplus
brew install instantclient-tools
实测发现，安装这些工具包后，可以通过sqlplus命令测试数据库连接，这在排查连接问题时非常有用。
2.2 验证安装路径
Homebrew通常会将Instant Client安装在以下路径之一：
- Intel Mac：
/usr/local/lib/instantclient_19_* - M1/M2 Mac：
/opt/homebrew/lib/instantclient_19_*
可以通过以下命令查找确切路径：
bash复制find /opt/homebrew/lib /usr/loc