代理环境下NPM安装Vue及执行命令时的网络错误求助

问题描述 #

• 尝试安装Vue，执行命令：

  C:\Users\jfalcon\Desktop\VUE>npm create vue@latest
  

• 首次报错：

  npm ERR! code ETIMEDOUT
  npm ERR! errno ETIMEDOUT
  npm ERR! network request to https://registry.npmjs.org/create-vue failed, reason:
  npm ERR! network 这是一个与网络连接相关的问题。
  npm ERR! network 大多数情况下是因为您处于代理环境或网络设置有误。
  npm ERR! network
  npm ERR! network 如果您处于代理环境，请确保'proxy'配置正确。参考：'npm help config'
  npm ERR! 本次运行的完整日志可在以下路径找到：
  C:\Users\jfalcon\AppData\Local\npm-cache_logs\2023-11-03T16_04_21_596Z-debug-0.log

• 已配置代理环境变量，但出现新错误：

  npm ERR! code ECONNRESET
  npm ERR! errno ECONNRESET
  npm ERR! network request to https://registry.npmjs.org/express failed, reason: Client network socket disconnected before secure TLS connection was established
  npm ERR! network 这是一个与网络连接相关的问题。
  npm ERR! network 大多数情况下是因为您处于代理环境或网络设置有误。
  npm ERR! network
  npm ERR! network 如果您处于代理环境，请确保'proxy'配置正确。参考：'npm help config'
  npm ERR! 本次运行的完整日志可在以下路径找到：C:\Users\jfalcon\AppData\Local\npm-cache_logs\2023-11-03T15_56_28_081Z-debug-0.log

• 所有npm命令均出现类似网络问题，推测是配置遗漏。

请问我忽略了什么配置细节？

排查解决方案 #

1. 补全npm代理配置 #

代理环境下，npm需要同时配置proxy和https-proxy，先查看当前配置：

npm config get proxy
npm config get https-proxy

如果未配置或地址错误，执行以下命令设置（替换为你的代理地址，比如http://proxy.example.com:8080）：

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

若代理需要账号密码，格式为http://username:password@proxy-address:port

2. 临时关闭严格SSL验证 #

代理环境常存在证书不兼容问题，导致TLS连接失败，可临时关闭测试：

npm config set strict-ssl false

测试通过后建议恢复默认设置：

npm config set strict-ssl true

3. 核对系统环境变量与npm配置一致性 #

检查系统级的HTTP_PROXY、HTTPS_PROXY环境变量，确保和npm配置的代理地址一致：

echo %HTTP_PROXY%
echo %HTTPS_PROXY%

若存在冲突，调整其中一方保持统一。

4. 清除npm缓存 #

缓存损坏可能导致请求异常，执行清理：

npm cache clean --force

5. 切换国内npm镜像（备选方案） #

如果代理配置始终无效，可尝试切换到国内镜像绕过代理问题：

npm config set registry https://registry.npmmirror.com/

内容的提问来源于stack exchange，提问作者Javier Alejandro Nuñez Falcón