快捷導(dǎo)航

解決前端報錯“opensslErrorStack:?[?'error:03000086:digital?envelope?routines::initialization?error'?]”

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

這篇文章主要介紹了前端報錯“opensslErrorStack:?[?'error:03000086:digital?envelope?routines::initialization?error'?]”的相關(guān)資料,文中將解決的辦法介紹的非常詳細(xì),需要的朋友可以參考下

報錯信息

前端啟動項目報錯，報錯信息如下：

$ 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兼容性問題，您在執(zhí)行yarn start期間遇到了ERR_OSSL_EVP_UNSUPPORTED錯誤。這個錯誤通常出現(xiàn)在Node.js 17版本及更高版本中，原因是在OpenSSL 3.0中默認(rèn)禁用了某些加密功能。

解決問題

1. 設(shè)置環(huán)境變量

錯誤可以通過設(shè)置一個環(huán)境變量來解決，這可以告訴Node.js使用OpenSSL 3.0的傳統(tǒng)提供者功能。

在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

這會臨時地為當(dāng)前會話設(shè)置環(huán)境變量。如果這解決了問題，您可能希望在環(huán)境中永久設(shè)置此更改，或者將其包含在項目啟動腳本中。

2. 更新包腳本

或者，您可以通過修改package.json腳本，在運行項目時包含此環(huán)境變量：

"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版本，可能不會出現(xiàn)這個問題。

對于生產(chǎn)應(yīng)用程序來說，降級到LTS版本（如16.x）可能是一個更穩(wěn)定的解決方案。
如果您使用的是早期版本的Node.js，或者更高版本可能仍存在與OpenSSL 3.0相關(guān)的未解決問題，請考慮升級到最新的LTS版本。

總結(jié)

到此這篇關(guān)于解決前端報錯“opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ]”的文章就介紹到這了,更多相關(guān)前端報錯opensslErrorStack error:03000086內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: