原文: Error: error:0308010c:digital envelope routines::unsupported [Node Error Solved]

如果你使用 Node.js 和命令行界面解决方案,如 Webpack、create-react-app 或 vue-cli-service,你可能已经遇到了这个错误,Error: error:0308010c:digital envelope routines::unsupported.

你并不孤单,因为我现在也遇到了:

ss1-1

React 应用程序确实未能启动:

ss2-1

在这篇文章中,你将学习如何通过 3 种方式来解决这个错误。但首先,让我们讨论一下导致该错误的原因。

什么原因导致 “0308010c:digital envelope routines::unsupported” 的错误?

你遇到这个错误的可能原因主要有两个:

  • 你没有使用 Node JS 的 LTS(长期支持)版本。你可以看到我使用的是 Node 17.0.0,这不是 Node 的 LTS 版本。
  • 你使用的 react-script 的版本小于 5。

这个错误也可能发生,因为你使用的是Node 17。

如何解决 “0308010c:digital envelope routines::unsupported” 的错误

你至少有 3 种方法可以解决这个错误。我们将一个一个地看。任何一个都应该对你有用。

将 --openssl-legacy-provider 传递给 Webpack 或 CLI 工具

例如,在 React 应用程序中,你可以将 --openssl-legacy-provider 传递给启动脚本,如 "react-scripts --openssl-legacy-provider start"

这应该就可以了。但是,如果这不能修复错误,那么就进行下一个修复。在许多情况下,它是有效的。

使用 Node JS  的 LTS 版本

考虑将你的 Node 版本降级到 16.16.0 或其他 LTS 版本。

目前,Node 的最新 LTS 版本是 18.12.1。你可以从 Node JS 官方网站下载它,或者使用 NVM 来安装它。

将 React 脚本升级到 5 以上版本

如果你正在使用 React,而这仍然无法为你解决错误,那么这很可能是你的 React 脚本的问题。

如果你使用的 React 脚本版本低于 5,那么你应该把它升级到 5+ 版本。

就我而言,我目前使用的是 react-scripts 3.4.3:

ss3

要将 react-scripts 升级到 5+,你可以通过两种方式进行:

卸载并重新安装 react-scripts

  • 打开终端,运行 npm uninstall react-scripts
  • 运行 npm install react-scripts

手动改变 react 脚本的版本

  • 进入你的 package.json,将 react-script 版本改为 5.0.2
  • 通过运行 rm –rf node_modules 删除 node_modules 文件夹
  • 通过运行 rm –rf package.lock.json 来删除 package.lock.json 文件
  • 运行 npm installyarn add,这取决于你所使用的软件包管理器

在将 react-scripts 的版本升级到 5+ 之后,我的 React 应用程序现在可以正常工作了:

ss4
ss5

总结

正如上文指出的,如果你收到 “0308010c:digital envelope routines::unsupported” 的错误,那么可能是你没有使用 Node JS 的 LTS 版本,或者你使用的 react-scripts 版本小于 5。

希望我们在本教程中讨论的修复方法能帮助你解决这个错误。如果其中一个修复方法不起作用,那么你可以尝试其他方法。在我的例子中,将 react-scripts 升级到 5 以上就行了。

谢谢你阅读本文。