Ubuntu环境下node_expat绑定文件找不到错误排查求助

错误信息 #

Error: Could not locate the bindings file. Tried:
 → /home/Project/node_modules/node-expat/build/node_expat.node
 → /home/Project/node_modules/node-expat/build/Debug/node_expat.node
 → /home/Project/node_modules/node-expat/build/Release/node_expat.node
 → /home/Project//node_modules/node-expat/out/Debug/node_expat.node
 → /home/Project/node_modules/node-expat/Debug/node_expat.node
 → /home/Project/node_modules/node-expat/out/Release/node_expat.node
 → /home/Project/node_modules/node-expat/Release/node_expat.node
 at bindings (/home/Project/node_modules/bindings/bindings.js:126:9)
    at Object.<anonymous> (/home/Project/node_modules/node-expat/lib/node-expat.js:4:34)
    at Module._compile (internal/modules/cjs/loader.js:778:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:789:10)
    at Module.load (internal/modules/cjs/loader.js:653:32)
    at tryModuleLoad (internal/modules/cjs/loader.js:593:12)
    at Function.Module._load (internal/modules/cjs/loader.js:585:3)
    at Module.require (internal/modules/cjs/loader.js:692:17)
    at require (internal/modules/cjs/helpers.js:25:18)
    at Object.<anonymous> (/home/Project/node_modules/xml2json/lib/xml2json.js:1:13)

环境信息 #

• Node版本：v10.24.1
• npm版本：6.14.12

已尝试操作 #

• 删除node_modules后重新安装依赖
• 单独执行npm install node-expat
• 安装最新版node-gyp：npm install node-gyp@latest
• 安装libxmljs@0.11.0

解决步骤 #

1. 补全系统编译依赖 #

node-expat是原生模块，需要系统具备基础编译环境和expat库：

• Debian/Ubuntu系统：

  sudo apt-get install build-essential libexpat1-dev
  

• CentOS/RHEL系统：

  sudo yum install gcc gcc-c++ make expat-devel
  

• macOS系统：

  xcode-select --install
  brew install expat
  

2. 清理缓存并强制源码编译 #

npm cache clean --force
rm -rf node_modules package-lock.json
npm install --build-from-source node-expat

--build-from-source参数会强制从源码编译模块，跳过预编译二进制包的拉取，避免版本不兼容问题。

3. 校准node-gyp的Python环境 #

Node.js 10.x兼容Python 2.7或3.5+，检查node-gyp配置：

node-gyp configure

如果提示Python版本错误，手动指定正确路径：

npm config set python /usr/bin/python2.7

4. 安装适配Node.js 10的node-expat版本 #

Node.js 10.x属于旧版本，尝试安装已知兼容的node-expat旧版本：

npm install node-expat@2.3.18

5. 替换依赖库（备选方案） #

如果上述方法都无效，可以更换不依赖原生模块的XML转JSON库，比如xml-js：

npm uninstall xml2json
npm install xml-js

之后修改代码中引用xml2json的部分，替换为xml-js的对应API即可。

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