从npm下载包时出现EPROTO SSL握手失败错误，如何解决？

修复步骤 #

• 切换npm镜像源
  国内网络环境下，官方源易出现SSL连接问题，切换至国内镜像源：

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

  再执行安装命令：

  npm install @capacitor/push-notifications
  

• 临时禁用SSL严格校验
  关闭npm的SSL证书校验（仅用于排查，安装完成后建议恢复）：

  npm config set strict-ssl false
  

  恢复命令：

  npm config set strict-ssl true
  

• 清除npm缓存
  缓存损坏可能引发SSL相关问题，强制清除后重试：

  npm cache clean --force
  

• 检查代理设置
  开启的代理可能干扰SSL握手，先关闭代理再尝试安装；若必须使用代理，配置npm代理：

  # 替换为实际代理地址和端口
  npm config set proxy http://your-proxy-address:port
  npm config set https-proxy http://your-proxy-address:port
  

• 更新系统SSL证书
  Windows系统通过「Windows更新」检查并安装根证书更新，或手动下载最新根证书包安装。

• 尝试用yarn替代npm
  若以上方法无效，换用yarn安装：

  # 先安装yarn
  npm install -g yarn
  # 执行安装
  yarn add @capacitor/push-notifications
  

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