安装node-rdkafka失败，遭遇node-gyp重建问题求助

我的Node.js应用需要kafka-streams库，目前了解到只有kafka-streams包是基于node-rdkafka构建的kafka-streams实现。成功安装kafka-streams后运行时，提示必须先安装node-rdkafka，但尝试安装node-rdkafka时遇到node-gyp重建失败的问题。

当前环境版本 #

• Node.js: v16.19.0
• npm: 8.19.3
• node-gyp: v9.4.0

执行命令及错误信息 #

执行命令：sudo npm install node-rdkafka

错误详情：

(base) n0p03px@m-c02f914ymd6n Kafka-Processor % sudo npm install node-rdkafka
npm WARN old lockfile 
npm WARN old lockfile The package-lock.json file was created with an old version of npm,
npm WARN old lockfile so supplemental metadata must be fetched from the registry.
npm WARN old lockfile 
npm WARN old lockfile This is a one-time fix-up, please be patient...
npm WARN old lockfile 
npm ERR! code 1
npm ERR! path /Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka
npm ERR! command failed
npm ERR! command sh -c -- node-gyp rebuild
npm ERR! ACTION deps_librdkafka_gyp_librdkafka_target_configure deps/librdkafka/config.h
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp info using node-gyp@9.1.0
npm ERR! gyp info using node@16.19.0 | darwin | x64
npm ERR! gyp info find Python using Python version 3.9.6 found at "/Applications/Xcode.app/Contents/Developer/usr/bin/python3"
npm ERR! gyp http GET https://nodejs.org/download/release/v16.19.0/node-v16.19.0-headers.tar.gz
npm ERR! gyp http 200 https://nodejs.org/download/release/v16.19.0/node-v16.19.0-headers.tar.gz
npm ERR! gyp http GET https://nodejs.org/download/release/v16.19.0/SHASUMS256.txt
npm ERR! gyp http 200 https://nodejs.org/download/release/v16.19.0/SHASUMS256.txt
npm ERR! gyp info spawn /Applications/Xcode.app/Contents/Developer/usr/bin/python3
npm ERR! gyp info spawn args [
npm ERR! gyp info spawn args   '/Users/n0p03px/.nvm/versions/node/v16.19.0/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py',
npm ERR! gyp info spawn args   'binding.gyp',
npm ERR! gyp info spawn args   '-f',
npm ERR! gyp info spawn args   'make',
npm ERR! gyp info spawn args   '-I',
npm ERR! gyp info spawn args   '/Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka/build/config.gypi',
npm ERR! gyp info spawn args   '-I',
npm ERR! gyp info spawn args   '/Users/n0p03px/.nvm/versions/node/v16.19.0/lib/node_modules/npm/node_modules/node-gyp/addon.gypi',
npm ERR! gyp info spawn args   '-I',
npm ERR! gyp info spawn args   '/Users/n0p03px/Library/Caches/node-gyp/16.19.0/include/node/common.gypi',
npm ERR! gyp info spawn args   '-Dlibrary=shared_library',
npm ERR! gyp info spawn args   '-Dvisibility=default',
npm ERR! gyp info spawn args   '-Dnode_root_dir=/Users/n0p03px/Library/Caches/node-gyp/16.19.0',
npm ERR! gyp info spawn args   '-Dnode_gyp_dir=/Users/n0p03px/.nvm/versions/node/v16.19.0/lib/node_modules/npm/node_modules/node-gyp',
npm ERR! gyp info spawn args   '-Dnode_lib_file=/Users/n0p03px/Library/Caches/node-gyp/16.19.0/<(target_arch)/node.lib',
npm ERR! gyp info spawn args   '-Dmodule_root_dir=/Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka',
npm ERR! gyp info spawn args   '-Dnode_engine=v8',
npm ERR! gyp info spawn args   '--depth=.',
npm ERR! gyp info spawn args   '--no-parallel',
npm ERR! gyp info spawn args   '--generator-output',
npm ERR! gyp info spawn args   'build',
npm ERR! gyp info spawn args   '-Goutput_dir=.'
npm ERR! gyp info spawn args ]
npm ERR! gyp info spawn make
npm ERR! gyp info spawn args [ 'BUILDTYPE=Release', '-C', 'build' ]
npm ERR! /bin/sh: -c: line 0: syntax error near unexpected token `('
npm ERR! /bin/sh: -c: line 0: `LD_LIBRARY_PATH=/Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka/build/Release/lib.host:/Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka/build/Release/lib.target:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH; cd ../deps; mkdir -p librdkafka; node ../util/configure'
npm ERR! make: *** [deps/librdkafka/config.h] Error 2
npm ERR! gyp ERR! build error 
npm ERR! gyp ERR! stack Error: `make` failed with exit code: 2
npm ERR! gyp ERR! stack     at ChildProcess.onExit (/Users/n0p03px/.nvm/versions/node/v16.19.0/lib/node_modules/npm/node_modules/node-gyp/lib/build.js:201:23)
npm ERR! gyp ERR! stack     at ChildProcess.emit (node:events:513:28)
npm ERR! gyp ERR! stack     at Process.ChildProcess._handle.onexit (node:internal/child_process:293:12)
npm ERR! gyp ERR! System Darwin 22.6.0
npm ERR! gyp ERR! command "/Users/n0p03px/.nvm/versions/node/v16.19.0/bin/node" "/Users/n0p03px/.nvm/versions/node/v16.19.0/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild"
npm ERR! gyp ERR! cwd /Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor/node_modules/node-rdkafka
npm ERR! gyp ERR! node -v v16.19.0
npm ERR! gyp ERR! node-gyp -v v9.1.0
npm ERR! gyp ERR! not ok

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/n0p03px/.npm/_logs/2023-10-23T07_40_56_421Z-debug-0.log

已尝试操作 #

• 更换多种Node.js和node-gyp版本组合，问题未解决

从错误日志看，核心问题是项目路径中包含空格和括号（My_Projects (new)），导致shell执行命令时解析出错，触发语法错误。以下是修复步骤：

1. 移动项目到无特殊字符的路径

   • 把项目从/Users/n0p03px/Documents/My_Projects (new)/Kafka-Processor移动到类似/Users/n0p03px/Documents/MyProjects/Kafka-Processor的路径，确保路径中没有空格、括号、特殊符号。

2. 清理残留文件

   • 删除项目根目录下的node_modules文件夹：rm -rf node_modules
   • 删除package-lock.json文件：rm package-lock.json
   • 清理npm缓存：npm cache clean --force

3. 重新安装依赖

   • 切换到新的项目路径，执行npm install node-rdkafka（无需sudo，除非权限问题）
   • 之后再安装kafka-streams：npm install kafka-streams

4. 额外检查（可选）

   • 确保Xcode命令行工具已安装：xcode-select --install
   • 确认Python版本符合node-gyp要求（node16对应Python3.6+）

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