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

无法使用create-react-app创建React项目,求助解决SSL解密失败错误

解决 ERR_SSL_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 错误(React项目创建失败)

你在执行npx create-react-app app创建React项目时遇到了SSL解密失败的错误,而且清理npm缓存后问题依然存在。这类问题大多和网络环境干扰、npm SSL配置或版本兼容性有关,下面是几个针对性的解决方案:

方案1:临时禁用npm的SSL验证

如果你的网络环境(比如公司防火墙、代理)干扰了SSL连接,可以临时关闭npm的严格SSL校验:

npm config set strict-ssl false

之后重新运行创建命令:

npx create-react-app app

⚠️ 注意:安装完成后记得重新开启SSL验证,保障后续包安装的安全性:

npm config set strict-ssl true

方案2:切换到国内npm镜像

npm官方源在国内访问可能存在不稳定的情况,切换到国内镜像(如淘宝镜像)可以规避这类网络/SSL问题:

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

设置完成后再次尝试创建项目。如果后续需要切回官方源,执行:

npm config set registry https://registry.npmjs.org/

方案3:更新Node.js和npm版本

旧版本的Node.js或npm可能存在SSL相关的已知bug,建议升级到稳定的LTS版本:

  1. 先查看当前版本:
node -v
npm -v
  1. 下载并安装最新的Node.js LTS版本,完成后重新执行项目创建命令。

方案4:彻底清理npm缓存与配置

虽然你已经执行过缓存清理,但可以尝试更彻底的重置:

npm cache clean --force

如果是Windows系统,手动删除C:\Users\parde\.npmrc文件;如果是macOS/Linux,执行rm -rf ~/.npmrc。之后重新初始化npm配置,再尝试创建项目。

方案5:检查并移除代理配置

如果你处于代理环境下,代理可能会干扰SSL连接:

  1. 查看当前代理配置:
npm config get proxy
npm config get https-proxy
  1. 如果存在代理配置,临时移除:
npm config delete proxy
npm config delete https-proxy

之后再次尝试安装。

备选方案:手动创建React项目

如果以上方法都无效,可以手动完成项目初始化:

  1. 创建项目目录并初始化package.json:
mkdir app
cd app
npm init -y
  1. 手动安装依赖:
npm install --no-audit --save --save-exact react react-dom react-scripts cra-template
  1. 在package.json中添加启动脚本:
"scripts": {
  "start": "react-scripts start",
  "build": "react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject"
}
  1. 创建public和src目录(参考React官方模板的目录结构),最后执行npm start启动项目。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.04.27 14:27:45