无法使用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版本:
- 先查看当前版本:
node -v npm -v
- 下载并安装最新的Node.js LTS版本,完成后重新执行项目创建命令。
方案4:彻底清理npm缓存与配置
虽然你已经执行过缓存清理,但可以尝试更彻底的重置:
npm cache clean --force
如果是Windows系统,手动删除C:\Users\parde\.npmrc文件;如果是macOS/Linux,执行rm -rf ~/.npmrc。之后重新初始化npm配置,再尝试创建项目。
方案5:检查并移除代理配置
如果你处于代理环境下,代理可能会干扰SSL连接:
- 查看当前代理配置:
npm config get proxy npm config get https-proxy
- 如果存在代理配置,临时移除:
npm config delete proxy npm config delete https-proxy
之后再次尝试安装。
备选方案:手动创建React项目
如果以上方法都无效,可以手动完成项目初始化:
- 创建项目目录并初始化package.json:
mkdir app cd app npm init -y
- 手动安装依赖:
npm install --no-audit --save --save-exact react react-dom react-scripts cra-template
- 在
package.json中添加启动脚本:
"scripts": { "start": "react-scripts start", "build": "react-scripts build", "test": "react-scripts test", "eject": "react-scripts eject" }
- 创建
public和src目录(参考React官方模板的目录结构),最后执行npm start启动项目。
内容的提问来源于stack exchange,提问作者Abhishek Pardeshi
相关产品推荐
相关产品推荐

