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

React中执行npx create-react-app出现ERR_OSSL_UNSUPPORTED错误的解决方法

解决npx create-react-app时的ERR_OSSL_UNSUPPORTED错误

这个错误是因为Node.js 17及以上版本默认启用OpenSSL 3.0,部分依赖包尚未适配新的加密算法导致的,以下是几种可行的解决办法:

临时启用旧加密算法(单次生效)

Windows CMD环境

先执行环境变量配置命令:

set NODE_OPTIONS=--openssl-legacy-provider

再执行创建React项目的命令:

npx create-react-app pro01

Windows PowerShell环境

先执行:

$env:NODE_OPTIONS="--openssl-legacy-provider"

再执行:

npx create-react-app pro01

永久配置环境变量

配置后每次打开终端都无需重复设置:

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「用户变量」或「系统变量」区域点击「新建」
  3. 变量名填写 NODE_OPTIONS,变量值填写 --openssl-legacy-provider
  4. 保存配置后重启终端,再执行 npx create-react-app pro01

降级Node.js版本

切换到Node.js 16.x LTS版本(使用OpenSSL 1.1.1,无兼容问题),推荐用nvm管理版本:

  1. 安装nvm后,执行:
nvm install 16.20.2
  1. 切换至该版本:
nvm use 16.20.2
  1. 再执行创建命令:
npx create-react-app pro01

使用Yarn替代npm创建项目

  1. 先全局安装Yarn:
npm install -g yarn
  1. 用Yarn创建React项目:
yarn create react-app pro01

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.04 01:30:22