MacBook M1 Pro设备Yarn安装Couchbase 3.2.1失败求助

核心问题分析 #

• Couchbase 3.2.1安装失败（Exit code:127）：该版本Node SDK仅支持Node.js 12/14/16/18，你的Node v20.5.0不在兼容列表内，且M1芯片编译依赖缺失也会导致命令执行失败。
• @newrelic/native-metrics安装失败：属于可选依赖，安装失败不影响核心业务，但编译依赖缺失或Node版本不兼容会触发报错。

步骤1：修复Couchbase 3.2.1安装问题 #

1. 降级Node.js到兼容版本
   使用n工具切换到v18.x LTS版本：

   n 18.17.1
   

   重启终端后验证版本：

   node -v
   

2. 安装M1编译必备依赖

   • 安装Xcode命令行工具：

     xcode-select --install
     

   • 通过Homebrew安装cmake与openssl 1.1（Couchbase依赖该版本）：

     brew install cmake openssl@1.1
     

   • 配置环境变量让包管理工具识别openssl：

     export OPENSSL_ROOT_DIR=$(brew --prefix openssl@1.1)
     export OPENSSL_LIBRARIES=$(brew --prefix openssl@1.1)/lib
     export OPENSSL_INCLUDE_DIR=$(brew --prefix openssl@1.1)/include
     

     可将上述命令添加到~/.zshrc或~/.bash_profile，避免每次重启终端重复配置。

3. 重新执行安装

   yarn install --ignore-optional
   

步骤2：处理@newrelic/native-metrics可选依赖 #

• 若无需该依赖，直接保留--ignore-optional参数执行安装即可，不影响项目核心功能。
• 若必须使用该依赖，确保Node版本为v18.x且已安装上述编译依赖，移除--ignore-optional参数重新执行yarn install。

验证 #

执行以下命令确认项目正常运行：

yarn start

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