npm install 或 run 常见报错及解决方案汇总

在运行 npm install 或 npm run 命令时，开发者可能会遇到各种报错。本文整理了几种常见错误的原因及对应的解决步骤，帮助快速排查问题。

第一种情况

npm ERR! Object for dependency "fsevents" is empty.

解决方法：请尝试删除项目根目录下的 package-lock.json 文件，然后重新执行安装命令。

第二种情况

fatal: unable to access 'https://github.com/nhn/raphael.git/': OpenSSL SSL_read: Connection was reset

错误原因：通常是由于网络问题导致无法访问 GitHub 服务器。

解决方法：

1. 尝试重新执行命令，或者使用代理工具（如梯子）解决网络访问问题。

2. 配置使用淘宝镜像源进行安装：

npm install --registry=https://registry.npm.taobao.org

第三种情况

Error: Can't find Python executable "python", you can set the PYTHON env variable.

错误原因：这通常是因为 node-sass 或 sass-loader 模块的版本与当前安装的 Node.js 版本不兼容。

解决方法：

请确保 Node.js 与 node-sass 模块版本匹配。在更改 node-sass 版本后，需同步调整对应的 sass-loader 版本以保持一致。

第四种情况

MSBUILD : error MSB3428: 未能加载 Visual C++ 组件“VCBuild.exe”

错误原因：Windows 环境下缺少必要的构建插件。

解决方法：

在命令行工具中运行以下命令全局安装 Windows 构建工具：npm install –global –production windows-build-tools。安装完成后，重新打开终端并执行 install 命令。

第五种情况

执行 npm run 命令时

error:03000086:digital envelope routines::initialization error

错误原因：当 Node.js 版本大于等于 17 时，默认启用 OpenSSL 3.0，该版本对允许的算法和密钥大小增加了严格限制，导致部分旧版库无法运行。

解决方法：

方案一：使用低于 17 版本的 Node.js。方案二：在命令行中设置环境变量 set NODE_OPTIONS=--openssl-legacy-provider，然后再执行 npm run dev 命令。

关于 npm install 命令持续失败的排查经验

执行 npm install 命令一直失败，主要报错原因如下：

reason: getaddrinfo EAI_AGAIN registry.npmjs.org    异常分析

近期主要在 VSCode 终端中执行安装操作。

```java
PS D:workSoftIntelliJ IDEAworkueue-admin-template-master> npm install
npm ERR! code EAI_AGAIN
npm ERR! errno EAI_AGAIN
npm ERR! request to http://registry.cnpmjs.org/axios failed, reason: getaddrinfo EAI_AGAIN registry.cnpmjs.org registry.cnpmjs.org:80
npm ERR! A complete log of this run can be found in:
npm ERR!     C:Program Files
odejs
ode_cache_logs?1-04-15T05_10_34_371Z-debug.log

通过搜索引擎查找到的多数解决方案主要涉及代理配置问题。

npm config set proxy null
npm config set https-proxy null
npm config set registry http://registry.npmjs.org/

建议依次执行上述相关命令进行测试，同时需要确保拥有执行以下语句的权限：

npm config set strict-ssl false

如果上述方法仍无效，建议尝试更换 VSCode 编辑器或 Node.js 版本。本人使用的配置为：

node-v10.12.0-x64
VSCodeUserSetup-x64-1.54.3

此外，尝试切换至移动热点网络，依次执行图片中所示的命令语句即可（具体哪一步生效尚不明确）。

总结

以上为个人实践经验总结，希望能为大家提供参考。欢迎大家支持本站。