解决前端报错“opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ]”

更新时间：2026年05月23日 15:11:32 作者：九尾cat

这篇文章主要介绍了前端报错“opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ]”的相关资料,文中将解决的办法介绍的非常详细,需要的朋友可以参考下

报错信息

前端启动项目报错，报错信息如下：

$ yarn start
yarn run v1.22.21
$ cross-env UMI_ENV=dev umi dev
Browserslist: caniuse-lite is outdated. Please run:
  npx update-browserslist-db@latest
  Why you should do it regularly: https://github.com/browserslist/update-db#readme
Bundle with webpack 5...
⏱️  MFSU Enabled
Starting the development server...

* Webpack █████████████████████████ building (10%) 0/2 entries 1/2 dependencies 0/1 modules 1 active
 ...odules\umi\node_modules\@umijs\preset-built-in\bundled\@pmmmwh\react-refresh-webpack-plugin\client\ReactRefreshEnt
ry.js

node:internal/crypto/hash:69
  this[kHandle] = new _Hash(algorithm, xofLen);
                  ^

Error: error:0308010C:digital envelope routines::unsupported
    at new Hash (node:internal/crypto/hash:69:19)
    at Object.createHash (node:crypto:133:10)
    at BulkUpdateDecorator.hashFactory (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:184161:18)
    at BulkUpdateDecorator.update (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:184062:50)
    at OriginalSource.updateHash (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack-sources2\index.js:1:51038)
    at NormalModule._initBuildHash (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:115961:17)
    at handleParseResult (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:116027:10)
    at D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:116119:4
    at processResult (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:115836:11)
    at D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:115900:5
    at D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:35132:3
    at iterateNormalLoaders (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:34958:10)
    at Array.<anonymous> (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:34949:4)
    at runCallbacks (D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:24341:15)
    at D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:24514:4
    at D:\桌面\fastapi-ui-ant-P12\node_modules\@umijs\deps\compiled\webpack\5\bundle5.js:33829:16 {
  opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
  library: 'digital envelope routines',
  reason: 'unsupported',
  code: 'ERR_OSSL_EVP_UNSUPPORTED'
}

Node.js v18.18.0
Done in 17.70s.

原因分析

由于Node.js和OpenSSL兼容性问题，您在执行yarn start期间遇到了ERR_OSSL_EVP_UNSUPPORTED错误。这个错误通常出现在Node.js 17版本及更高版本中，原因是在OpenSSL 3.0中默认禁用了某些加密功能。

解决问题

1. 设置环境变量

错误可以通过设置一个环境变量来解决，这可以告诉Node.js使用OpenSSL 3.0的传统提供者功能。

在Windows上（命令行）：

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

在Windows上（Powershell）：

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

在macOS或Linux上：

export NODE_OPTIONS=--openssl-legacy-provider
yarn start

这会临时地为当前会话设置环境变量。如果这解决了问题，您可能希望在环境中永久设置此更改，或者将其包含在项目启动脚本中。

2. 更新包脚本

或者，您可以通过修改package.json脚本，在运行项目时包含此环境变量：

"scripts": {
  "start": "cross-env NODE_OPTIONS=--openssl-legacy-provider umi dev",
  "build": "cross-env NODE_OPTIONS=--openssl-legacy-provider umi build"
}

3. 升级或降级Node.js

如果上述解决方案不可行，考虑更改Node.js版本。早于17版本的Node.js版，或者最新的LTS版本，可能不会出现这个问题。

对于生产应用程序来说，降级到LTS版本（如16.x）可能是一个更稳定的解决方案。
如果您使用的是早期版本的Node.js，或者更高版本可能仍存在与OpenSSL 3.0相关的未解决问题，请考虑升级到最新的LTS版本。

总结

到此这篇关于解决前端报错“opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ]”的文章就介绍到这了,更多相关前端报错opensslErrorStack error:03000086内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Nest.js使用multer实现文件上传功能
这篇文章主要为大家详细介绍了Nest.js鹅湖使用multer实现文件上传功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2024-03-03
Node.js中的文件系统(file system)模块详解
Node.js文件系统模块提供了丰富的方法,用于读取、写入、操作文件和目录,文件系统模块是Node.js强大而灵活的一部分,为文件操作提供了方便的API,本文给大家介绍Node.js中的文件系统（file system）模块,感兴趣的朋友一起看看吧
2023-11-11
Node.js的Mongodb使用实例
本篇文章主要介绍了Node.js的Mongodb使用实例，具有一定的参考价值，有兴趣的可以了解一下。
2016-12-12
详解如何查看node端口被占用并杀死
这篇文章主要给大家介绍了如何查看node端口被占用并杀死,文中给出了相关的解决方法,并通过代码示例给大家介绍的非常详细,对前端开发要学会如何查看端口占用并杀死非常有用,需要的朋友可以参考下
2024-01-01
NodeJS服务器实现gzip压缩的示例代码
这篇文章主要介绍了NodeJS服务器实现gzip压缩的示例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-10-10
Nodejs异步回调的优雅处理方法
这篇文章主要介绍了Nodejs异步回调的优雅处理方法,本文使用了ES6中的新特性,用一种十分优雅的方式解决了回调问题,需要的朋友可以参考下
2014-09-09
node实现生成带参数的小程序二维码并保存到本地功能示例
这篇文章主要介绍了node实现生成带参数的小程序二维码并保存到本地功能,涉及nodejs模块引用、接口调用、编码转换、图片生成等相关操作技巧,需要的朋友可以参考下
2018-12-12
node.js中的emitter.on方法使用说明
这篇文章主要介绍了node.js中的emitter.on方法使用说明,本文介绍了emitter.on的方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
2014-12-12
NodeJs操作MYSQL方法详细介绍
本章将了解如何在nodejs中操作Mysql，实际项目中不可能用workbench来进行增删改查，而是用代码操作，接下来我们讲解一下如何在 nodejs中操作Mysql
2022-08-08
Windows 系统下安装和部署Egret的开发环境
Egret基于TypeScript开发的，而TypeScript编译工具tsc是基于Node.js 开发的。所以在安装过程中，我们先需要对于基础支持工具进行安装。
2014-07-07