React新手运行lightence-ant-design模板遇ERR_OSSL_EVP_UNSUPPORTED错误求助

你遇到的这个错误是因为Node.js v17及以上版本默认启用了更严格的OpenSSL安全配置，而项目依赖的webpack或react-scripts版本较旧，仍在使用已被弃用的哈希算法，导致启动失败。以下是几种可行的解决方法：

方法1：临时添加环境变量启动 #

根据你的操作系统，在终端执行对应命令：

• Windows（CMD）：

  set NODE_OPTIONS=--openssl-legacy-provider && yarn start
  

• Windows（PowerShell）：

  $env:NODE_OPTIONS="--openssl-legacy-provider"; yarn start
  

• macOS/Linux：

  NODE_OPTIONS=--openssl-legacy-provider yarn start
  

方法2：修改package.json永久生效 #

打开项目根目录的package.json，找到scripts字段下的start命令，修改为：

"scripts": {
  "start": "NODE_OPTIONS=--openssl-legacy-provider react-scripts start",
  // 其他脚本（build、test等）保持不变
}

Windows用户如果使用CMD，需要把命令改成：

"start": "set NODE_OPTIONS=--openssl-legacy-provider && react-scripts start"

修改后直接运行yarn start即可。

方法3：降级Node.js版本（可选） #

如果不想使用兼容模式，可以用版本管理工具（如nvm）将Node.js降级到v16.x版本（该版本默认不会触发此问题）：

1. 安装nvm后，执行nvm install 16
2. 切换版本：nvm use 16
3. 重新执行yarn install && yarn start

内容的提问来源于stack exchange，提问作者JuniorJ