执行npm install -g java命令报错，请求协助排查修复

问题重现 #

执行npm install -g java时出现node-gyp配置错误，核心报错为网络连接异常，完整执行日志如下：

C:\WINDOWS\system32>npm i -g java

> java@0.12.2 install C:\Dev\Software\npm-repository\npm\node_modules\java
> node-gyp rebuild

C:\Dev\Software\npm-repository\npm\node_modules\java>if not defined npm_config_node_gyp (node "C:\Dev\Software\npm-repository\npm\node_modules\npm\node_modules\npm-lifecycle\node-gyp-bin\\..\..\node_modules\node-gyp\bin\node-gyp.js" rebuild )  else (node "C:\Dev\Software\npm-repository\npm\node_modules\npm\node_modules\node-gyp\bin\node-gyp.js" rebuild )
gyp WARN install got an error, rolling back install
gyp ERR! configure error
gyp ERR! stack Error: This is most likely not a problem with node-gyp or the package itself and
gyp ERR! stack is related to network connectivity. In most cases you are behind a proxy or have bad
gyp ERR! stack network settings.
gyp ERR! stack     at Request.<anonymous> (C:\Dev\Software\npm-repository\npm\node_modules\npm\node_modules\node-gyp\lib\install.js:171:21)
gyp ERR! stack     at Request.emit (events.js:315:20)
gyp ERR! stack     at Request.onRequestError (C:\Dev\Software\npm-repository\npm\node_modules\npm\node_modules\request\request.js:881:8)
gyp ERR! stack     at ClientRequest.emit (events.js:315:20)
gyp ERR! stack     at TLSSocket.socketErrorListener (_http_client.js:469:9)
gyp ERR! stack     at TLSSocket.emit (events.js:315:20)
gyp ERR! stack     at emitErrorNT (internal/streams/destroy.js:106:8)
gyp ERR! stack     at emitErrorCloseNT (internal/streams/destroy.js:74:3)
gyp ERR! stack     at processTicksAndRejections (internal/process/task_queues.js:80:21)
gyp ERR! System Windows_NT 10.0.19042
gyp ERR! command "C:\\Program Files\\nodejs\\node.exe" "C:\\Dev\\Software\\npm-repository\\npm\\node_modules\\npm\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild"
gyp ERR! cwd C:\Dev\Software\npm-repository\npm\node_modules\java
gyp ERR! node -v v14.16.1
gyp ERR! node-gyp -v v5.1.0
gyp ERR! not ok
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! java@0.12.2 install: `node-gyp rebuild`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the java@0.12.2 install script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

解决方案 #

1. 排查并修复网络代理设置 #

• 查看当前npm代理配置：

  npm config get proxy
  npm config get https-proxy
  

• 若存在无效代理，执行以下命令清空：

  npm config delete proxy
  npm config delete https-proxy
  

• 若处于企业代理环境，设置正确的代理地址（替换为实际代理地址）：

  npm config set proxy http://your-proxy-address:port
  npm config set https-proxy http://your-proxy-address:port
  

• 同时检查系统环境变量中的HTTP_PROXY和HTTPS_PROXY，确保与npm配置一致。

2. 配置node-gyp国内镜像加速下载 #

node-gyp需要下载node源码包，国内环境可切换到淘宝镜像：

npm config set disturl https://npm.taobao.org/dist
npm config set node_gyp https://github.com/nodejs/node-gyp/releases/download/v9.4.0/node-gyp-v9.4.0.tar.gz

也可临时使用cnpm安装：

cnpm install -g java

3. 确保node-gyp依赖环境完整 #

Windows下node-gyp需要以下环境，若缺失也可能导致安装失败：

• 安装Python 3.7~3.10版本（适配node v14），并添加到系统PATH
• 安装Visual Studio Build Tools，勾选「Desktop development with C++」组件
• 配置npm指向正确的Python路径和VS版本：

  npm config set python python3.9
  npm config set msvs_version 2019
  

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

npm cache clean --force
npm uninstall -g java
npm install -g java

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