npm安装bcrypt@5失败 报错unable to get local issuer certificate

根因定位 #

报错核心原因为SSL证书校验失败：

1. node-pre-gyp拉取bcrypt预编译二进制包时触发证书校验错误，无法下载预构建文件
2. 回退到源码编译流程后，node-gyp拉取对应版本Node.js头文件时再次触发相同的证书校验错误，导致编译流程终止

解决方案 #

按优先级从高到低尝试以下方案：

• 方案1：临时关闭npm SSL校验（仅临时使用，安装完成后建议恢复）
  执行命令：

  npm config set strict-ssl false
  npm install bcrypt
  # 安装完成后恢复校验
  npm config set strict-ssl true
  

• 方案2：替换为国内npm镜像（适合国内网络环境）
  执行命令配置镜像后再安装：

  npm config set registry https://registry.npmmirror.com
  npm config set disturl https://npmmirror.com/mirrors/node/
  npm install bcrypt
  

• 方案3：替换为纯JS实现的兼容包
  无需编译环境，API和原生bcrypt完全兼容，直接替换依赖即可：

  npm install bcryptjs
  

  业务代码仅需修改引入语句，原有加密、比对逻辑无需调整。
• 方案4：安装Windows编译依赖（必须使用原生bcrypt时选择）
  以管理员身份打开PowerShell，执行命令安装编译工具链：

  npm install --global windows-build-tools
  

  安装完成后再重新执行bcrypt安装命令即可。

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