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

使用npx create-react-app创建React项目时报ERR_SSL_DECRYPTION_FAILED_OR_BAD_RECORD_MAC错误

ERR_SSL_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 错误排查方案

该错误为npm拉取依赖时HTTPS链路SSL解密失败导致,可按以下顺序排查解决:

  • 第一步:清理损坏的npm缓存
    执行命令:
    npm cache clean --force
    清理完成后重试npx create-react-app first-app命令。
  • 第二步:关闭代理/抓包/网络监控工具
    Fiddler、Charles、VPN、公司内网代理、杀毒软件网络审计功能都会对HTTPS请求做中间人拦截,临时关闭所有此类工具后重试。
  • 第三步:切换国内npm镜像源
    官方npm源网络波动也会触发SSL握手异常,执行命令切换为淘宝镜像源:
    npm config set registry https://registry.npmmirror.com/
    切换完成后重试创建项目操作。
  • 第四步:临时关闭SSL校验(测试用,完成后立刻恢复)
    如果以上步骤都无效,可临时关闭SSL校验测试:
    npm config set strict-ssl false
    安装成功后执行npm config set strict-ssl true恢复配置,避免安全风险。
  • 第五步:重置npm全局配置
    如果之前修改过npm代理配置异常,执行以下命令重置:
npm config delete proxy
npm config delete https-proxy
npm config delete strict-ssl
npm config delete registry

重置完成后重新按第三步切换镜像源再重试。

  • 第六步:升级npm兼容版本
    你当前使用的npm 8.1.0存在已知SSL相关bug,可升级到Node 14对应的兼容LTS版本:
    npm install -g npm@8.19.4
    升级完成后再尝试创建项目。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.30 15:06:03