如何处理 Node 报错 Error: error:0308010c

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

你并不孤单，因为我现在也遇到了：

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

在这篇文章中，你将学习如何通过 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：

要将 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 install 或 yarn add，这取决于你所使用的软件包管理器

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

总结

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

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