You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

npm install时报SSL routines:ssl3_get_record解密失败错误如何解决?

npm install 报SSL decryption failed错误解决方案

其他同事可正常运行同一份代码,说明问题出在你本地的网络配置或Node.js环境兼容性上,与代码本身无关。

该错误为npm与包源服务器建立SSL连接时解密失败导致,与你本地安装的Python 3.8.3无关联。

1. 网络与代理配置排查

绝大多数同类问题由代理配置不匹配、公司内网SSL中间人审计导致,可按以下步骤处理:

  • 查看当前npm代理配置
    npm config get proxy
    npm config get https-proxy
    
    如果返回结果和你当前系统使用的代理地址不一致,或你当前未使用代理却返回了配置值,先清除旧代理配置:
    npm config delete proxy
    npm config delete https-proxy
    
    如果你确实需要通过代理访问网络,将npm代理配置为和系统代理一致:
    npm config set proxy http://<你的代理地址>:<端口>
    npm config set https-proxy http://<你的代理地址>:<端口>
    
  • 临时关闭SSL严格校验(仅建议在内网可信环境下使用,安装完成后可改回true恢复校验)
    npm config set strict-ssl false
    
    配置完成后重新执行npm install测试。

2. 切换npm包源

默认官方npm源连接不稳定也可能触发SSL连接异常,可切换为国内淘宝镜像源:

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

切换完成后重新执行npm install测试。

3. 更换Node.js版本

你当前使用的Node.js 14.7.6搭配npm 7.x存在多个已知的SSL相关兼容性bug,可通过nvm(Windows系统使用nvm-windows)切换为更稳定的Node.js LTS版本,比如Node.js 16.x LTS、18.x LTS,切换版本后重新执行安装操作即可。

4. 替换包管理器

如果以上方案都无效,可使用pnpm或yarn替代npm执行依赖安装,多数情况下npm独有的网络问题更换包管理器后可直接解决:

# 安装pnpm
npm install -g pnpm
# 使用pnpm安装依赖
pnpm install

内容的提问来源于stack exchange,提问作者Lio

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 14:48:01