使用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
相关产品推荐
相关产品推荐

