Mac M1使用oracledb遇架构不兼容问题，求解决方案

你的错误核心是当前使用的Oracle Instant Client为x86_64架构，与M1芯片的arm64e架构不匹配，导致库文件无法加载。以下是几种可行的解决方法：

方法1：安装arm64版本的Oracle Instant Client #

• Oracle从Instant Client 19.13版本开始正式支持Apple Silicon（arm64），下载对应版本的Instant Client（推荐19.18或更高版本）
• 解压后配置环境变量：

  # 临时生效，终端重启后失效
  export DYLD_LIBRARY_PATH=/path/to/your/instantclient_arm64:$DYLD_LIBRARY_PATH
  
  # 永久生效，添加到~/.zshrc或~/.bash_profile
  echo 'export DYLD_LIBRARY_PATH=/path/to/your/instantclient_arm64:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  source ~/.zshrc
  

• 重新运行Node.js项目

方法2：通过Rosetta 2运行x86架构的Node.js #

• 打开终端时右键选择「使用Rosetta打开」
• 用nvm安装x86版本的Node.js：

  arch -x86_64 nvm install <node_version>
  arch -x86_64 nvm use <node_version>
  

• 确保项目依赖（包括oracledb）在该x86环境下重新安装，之后运行项目即可兼容原x86_64的Oracle客户端

方法3：使用oracledb的Thin模式（无需本地客户端） #

• 确保oracledb版本≥5.0，Thin模式是该版本新增特性
• 在代码中初始化时跳过本地客户端加载：

  const oracledb = require('oracledb');
  
  // 初始化时不依赖本地客户端
  await oracledb.initOracleClient({ libDir: null });
  
  // 使用Thin模式连接数据库，示例连接字符串
  const connection = await oracledb.getConnection({
    user: '你的用户名',
    password: '你的密码',
    connectString: '数据库主机:1521/服务名?mode=thin'
  });
  

• 该方式无需安装本地Oracle客户端，直接通过网络连接数据库，彻底规避架构兼容问题

错误原文：
Error: DPI-1047: Cannot locate a 64-bit Oracle Client library: "dlopen(/Users/.../mac_client/instantclient_19_8/libclntsh.dylib, 0x0001): tried: '/Users/.../mac_client/instantclient_19_8/libclntsh.dylib' (mach-o file, but is an incompatible architecture (have (x86_64), need (arm64e)))"

内容的提问来源于stack exchange，提问作者Joe