执行ionic start创建Vue项目时遇npm网络及SSL错误求助

问题描述 #

按照Ionic官方CLI教程创建首个Vue项目时，反复出现npm网络连接中断及SSL解密失败错误，已尝试重装Node.js、卸载Ionic后执行npm cache clear --force再重装、管理员模式启动VS Code，问题仍未解决。错误信息如下：

? Starter template: blank
√ Preparing directory .\myapp in 1.41ms
√ Downloading and extracting blank starter in 320.71ms
> ionic integrations enable capacitor --quiet -- myapp io.ionic.starter
> npm.cmd i --save -E @capacitor/core@latest
npm警告：全局配置`--global`、`--local`已弃用，请改用`--location=global`。
npm警告：ERESOLVE 覆盖对等依赖
npm错误！代码 ECONNRESET
npm错误！网络连接中断
npm错误！此问题与网络连接相关
npm错误！多数情况是处于代理环境或网络设置异常
npm错误！
npm错误！若处于代理环境，请确保'proxy'配置正确。详见：'npm help config'

npm错误！本次运行的完整日志可在以下路径查看：
npm错误！     C:\Users\User\AppData\Local\npm-cache\_logs\2022-07-18T02_58_39_592Z-debug-0.log
[ERROR] 运行子进程npm时发生错误。

        npm.cmd i --save -E @capacitor/core@latest 以退出码1结束。

        添加--verbose标志重新运行命令可能获取更多信息。

安装依赖可能需要数分钟。

  ──────────────────────────────────────────────────────────────────────────────

         Ionic Advisory，Ionic提供的定制解决方案与专家服务

                             更快推向市场
                    实时故障排查与指导
        定制培训、最佳实践、代码与架构评审
      开发生命周期各阶段的定制策略

               了解更多：https://ion.link/advisory

  ──────────────────────────────────────────────────────────────────────────────


> npm.cmd i
npm警告：全局配置`--global`、`--local`已弃用，请改用`--location=global`。
npm警告：ERESOLVE 覆盖对等依赖
npm错误！代码 ERR_SSL_DECRYPTION_FAILED_OR_BAD_RECORD_MAC
npm错误！13168:error:1408F119:SSL routines:ssl3_get_record:decryption failed or bad record mac:c:\ws\deps\openssl\openssl\ssl\record\ssl3_record.c:677:
npm错误！

npm错误！本次运行的完整日志可在以下路径查看：
npm错误！     C:\Users\User\AppData\Local\npm-cache\_logs\2022-07-18T02_59_54_033Z-debug-0.log
[ERROR] 运行子进程npm时发生错误。

        npm.cmd i 以退出码1结束。

        添加--verbose标志重新运行命令可能获取更多信息。

解决步骤 #

1. 重置npm代理设置 #

网络中断错误大概率和代理配置有关，先检查并清空代理：

• 查看当前代理配置：

  npm config get proxy
  npm config get https-proxy
  

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

  npm config delete proxy
  npm config delete https-proxy
  

• 或直接设置为空值：

  npm config set proxy ""
  npm config set https-proxy ""
  

2. 切换npm镜像源为国内源 #

默认npm源在国内访问不稳定，切换到国内镜像源：

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

验证镜像源是否生效：

npm config get registry

3. 临时禁用SSL严格校验 #

针对SSL解密失败错误，可临时关闭npm的SSL严格校验：

npm config set strict-ssl false

4. 清理缓存并手动安装依赖 #

进入项目目录，重新清理缓存并安装：

cd myapp
npm cache clean --force
npm install

5. 检查防火墙/杀毒软件拦截 #

部分防火墙或杀毒软件会拦截npm的网络请求，尝试临时关闭相关软件后重新执行项目创建命令。

6. 安装Node.js LTS稳定版本 #

确保使用的是Node.js长期支持（LTS）版本，避免因版本兼容问题导致的网络异常。

关于npm全局配置警告 #

针对--global/--local弃用的警告，后续全局安装包时改用以下格式：

npm install -g <包名> --location=global

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