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

React Native报ERR_OSSL_EVP_UNSUPPORTED,添加legacy参数仍未解决怎么办

原因分析及解决方案

这个错误本质是Node.js 17及以上版本默认使用OpenSSL 3.0,你项目用到的低版本metro打包工具依赖的旧哈希算法在OpenSSL 3.0中被禁用导致,你之前添加的兼容参数仅覆盖了react-scripts相关命令,没有作用到React Native的打包流程,因此报错没有生效,具体原因和对应解决方法如下:

可能的原因

    1. 脚本参数覆盖范围不全
      你仅在build、start两个react-scripts相关命令中加了--openssl-legacy-provider参数,但运行React Native项目用的react-native run-android、react-native run-ios`脚本没有添加该参数,启动的metro打包服务没有加载OpenSSL兼容配置,依然会触发错误。
    1. 环境变量配置缺失
      仅在单条命令添加的参数仅对当前命令生效,如果打包流程涉及子进程调用时,子进程没有继承到兼容参数,依旧会触发报错。
    1. 项目缓存残留旧缓存未清理
      之前的错误打包缓存、依赖缓存没有清理,新的兼容配置无法覆盖旧缓存逻辑,导致配置不生效。
    1. Windows系统命令参数传递异常
      你当前使用Windows系统,不同终端(cmd/PowerShell/Git Bash)对命令参数的传递规则不同,直接添加的参数可能无法被正确识别。
    1. Node版本与项目依赖适配性问题
      你使用的RN 0.66.3是2021年发布的版本,对应的metro版本默认适配OpenSSL 1.1,和Node 17+自带的OpenSSL 3.0兼容度较低,即便加了参数也可能存在适配异常。

对应解决方法

  1. 给RN启动脚本添加兼容参数
    根据你使用的终端类型,修改package.json里的对应脚本:
  • Mac/Linux/ Git Bash终端:
"android": "NODE_OPTIONS=--openssl-legacy-provider react-native run-android",
"ios": "NODE_OPTIONS=--openssl-legacy-provider react-native run-ios",
  • Windows cmd终端:
"android": "set NODE_OPTIONS=--openssl-legacy-provider && react-native run-android",
"ios": "set NODE_OPTIONS=--openssl-legacy-provider && react-native run-ios",
  • Windows PowerShell终端:
"android": "$env:NODE_OPTIONS=\"--openssl-legacy-provider\"; react-native run-android",
"ios": "$env:NODE_OPTIONS=\"--openssl-legacy-provider\"; react-native run-ios",
  1. 全局设置兼容环境变量
    Windows系统在系统环境变量中新增变量名NODE_OPTIONS,值设为--openssl-legacy-provider,设置完成后重启终端生效。
    Mac/Linux系统在~/.bashrc、~/.zshrc等终端配置文件中添加export NODE_OPTIONS=--openssl-legacy-provider,执行source对应配置文件后生效。
  2. 清理所有缓存后重启项目
    依次执行以下命令:
rm -rf node_modules
rm package-lock.json yarn.lock
npm cache clean --force
npm install
npx react-native start --reset-cache
  1. 降级Node.js版本
    如果以上方法都不生效时,直接将Node.js降级到16.x LTS版本,该版本默认使用OpenSSL 1.1,和你当前使用的RN 0.66.3版本完全兼容,不需要额外添加任何参数即可正常运行。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.24 22:54:03