解决node-gyp报错：self-signed certificate in certificate chain问题咨询

问题核心 #

执行操作时触发node-gyp报错，关键错误信息：

gyp ERR! stack FetchError: request to https://nodejs.org/download/release/v18.0.0/node-v18.0.0-headers.tar.gz failed, reason: self-signed certificate in certificate chain

已尝试npm config set strict-ssl false但无效，可尝试以下解决方案：

可行方案 #

1. 手动指定本地headers包路径

• 前往Node.js官网下载对应版本的headers包：node-v18.0.0-headers.tar.gz
• 执行命令跳过在线下载，直接使用本地包：

  node-gyp configure --tarball "C:\path\to\your\downloaded\node-v18.0.0-headers.tar.gz"
  

• 也可通过npm全局配置永久指定：

  npm config set node_gyp_headers "file:///C:/path/to/node-v18.0.0-headers.tar.gz"
  

2. 信任内网自签名证书

若为公司内网环境的自签名证书：

• 将证书文件（.crt格式）导入Windows系统的「受信任的根证书颁发机构」
• 配置npm信任该证书：

  npm config set ca "C:\path\to\your\internal-cert.crt"
  

3. 切换Node.js稳定版本

部分Node.js版本与node-gyp的证书处理逻辑存在兼容问题：

• 使用nvm切换至同大版本的稳定版（如v18.19.0）：

  nvm install 18.19.0
  nvm use 18.19.0
  

• 重新执行原操作验证问题是否解决

4. 更换node-gyp下载源

通过国内镜像源绕过证书验证：

npm config set disturl https://registry.npmmirror.com/-/binary/node/

设置后，node-gyp会从国内镜像下载headers包，无需验证原官网证书

内容的提问来源于stack exchange，提问作者A.Serobabov