NodeJS项目依赖安装失败求助：已升级依赖及npm仍无法解决

问题说明 #

升级所有依赖包及npm版本后，执行npm install仍无法完成项目依赖安装。

项目package.json配置 #

{
  "name": "task",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node app"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "bcrypt": "^5.1.0",
    "body-parser": "^1.19.0",
    "connect-mongo": "^3.2.0",
    "ejs": "^3.1.6",
    "express": "^4.18.1",
    "express-fileupload": "^1.4.0",
    "express-flash": "^0.0.2",
    "express-session": "^1.17.3",
    "lodash": "^4.17.21",
    "mongodb": "^4.9.1",
    "mongoose": "^6.0.5",
    "multer": "^1.4.3",
    "node": "^16.6.1",
    "nodemailer": "^6.7.0",
    "nodemon": "^2.0.13",
    "open": "^8.4.0",
    "passport": "^0.6.0",
    "passport-local": "^1.0.0",
    "simplebar": "^5.3.5"
  }
}

报错核心信息 #

从截图可知，错误源于bcrypt包安装失败，触发node-gyp编译异常，具体表现为：

• 找不到适配的Python环境（如提示缺少Python 2.7）
• Windows环境下提示无法加载Visual C++编译组件，Linux/macOS下提示缺少编译工具链

解决步骤 #

1. 移除无效依赖项 #

package.json的dependencies中包含错误配置："node": "^16.6.1"。node是项目运行环境，不属于依赖包范畴，直接将其从依赖列表中删除。

2. 修复bcrypt编译环境 #

bcrypt需要本地编译环境支持，按操作系统分别处理：

• Windows：
  以管理员权限打开命令提示符，安装编译工具：

  npm install --global windows-build-tools
  

  或手动安装Visual Studio Build Tools，勾选「C++开发工具」组件。
• macOS：
  安装Xcode命令行工具：

  xcode-select --install
  

• Linux（以Ubuntu为例）：
  安装编译依赖包：

  sudo apt-get install build-essential python2.7
  

3. 替换为免编译的加密包 #

若编译问题无法快速解决，可改用无需编译的bcryptjs替代bcrypt，两者API基本兼容：

# 卸载原bcrypt
npm uninstall bcrypt
# 安装bcryptjs
npm install bcryptjs

之后修改项目中引用bcrypt的代码，替换为bcryptjs即可。

4. 清除缓存后重新安装 #

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

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