node.js运行项目时提示digital envelope routines::unsupported

在运行VuePress项目时遇到Error:error:0308010C:digitalenveloperoutines::unsupported的问题,原因是Node.js的OpenSSL版本过低。解决方案包括降级到node@14或使用--openssl-legacy-provider选项。在package.json的scripts中添加环境变量设置可临时解决此问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

背景

在运行vuepress项目或者其他项目时,出现的问题。

遇到的问题

Error: error:0308010C:digital envelope routines::unsupported
at new Hash (node:internal/crypto/hash:71:19)
at Object.createHash (node:crypto:133:10)
at module.exports (D:\code\Resume-vuepress\node_modules\webpack\lib\util\createHash.js:135:53)
at NormalModule._initBuildHash (D:\code\Resume-vuepress\node_modules\webpack\lib\NormalModule.js:417:16)
at handleParseError (D:\code\Resume-vuepress\node_modules\webpack\lib\NormalModule.js:471:10)
at D:\code\Resume-vuepress\node_modules\webpack\lib\NormalModule.js:503:5
at D:\code\Resume-vuepress\node_modules\webpack\lib\NormalModule.js:358:12
at D:\code\Resume-vuepress\node_modules\loader-runner\lib\LoaderRunner.js:373:3
at iterateNormalLoaders (D:\code\Resume-vuepress\node_modules\loader-runner\lib\LoaderRunner.js:214:10)
at Array.<anonymous> (D:\code\Resume-vuepress\node_modules\loader-runner\lib\LoaderRunner.js:205:4)
at Storage.finished (D:\code\Resume-vuepress\node_modules\enhanced-resolve\lib\CachedInputFileSystem.js:55:16)
at D:\code\Resume-vuepress\node_modules\enhanced-resolve\lib\CachedInputFileSystem.js:91:9
at D:\code\Resume-vuepress\node_modules\graceful-fs\graceful-fs.js:123:16
at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read_file_context:68:3) {
opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'
}

Node.js v18.14.2

原因:

这个错误是因为 Node.js 中的加密库 OpenSSL 版本过低,无法支持算法。您可以尝试使用 node@14 版本,或者在安装 Node.js 时选择包含较新的 OpenSSL 版本。如果您确实需要使用 Node.js v18.14.2 版本,可以更新 OpenSSL 版本来解决这个问题。具体的做法可以参考 OpenSSL 官方文档:https://www.openssl.org/docs/

解决办法

在package.json文件中,修改为如下格式:

  "scripts": {
    "dev": "SET NODE_OPTIONS=--openssl-legacy-provider && vuepress dev src",
    "build": "SET NODE_OPTIONS=--openssl-legacy-provider && vuepress build src"
  },

后面的vuepress dev src目录自行替换成你项目中的命令即可
vuepress build src 同理

附件

参考:node.js升级踩坑记录–digital envelope routines unsupported
Nodejs运行vue项目时,报错:Error: error:0308010C:digital envelope routines::unsupported

### 关于Node.js 22.13.0 OpenSSL 错误解决方案 当使用 Node.js 22.13.0 版本,如果遇到 `error:0308010C:digital envelope routines::unsupported` 的 OpenSSL 错误,这通常是因为某些依赖库尝试使用不再支持的操作所致。此问题可以通过调整环境变量或修改启动参数来解决。 #### 方法一:通过命令行设置环境变量 可以在执行脚本之前临禁用特定的加密算法: ```bash export NODE_OPTIONS=--openssl-legacy-provider ``` 对于 Windows 用户,则可以使用 PowerShell 或者 CMD 设置环境变量: ```powershell $env:NODE_OPTIONS="--openssl-legacy-provider" ``` 这种方法适用于不想永久改变系统配置的情况,在会话结束之后该设置也会失效[^1]。 #### 方法二:编辑启动文件 另一种更持久的方法是直接在应用程序入口处加入如下代码片段: ```javascript process.env.NODE_OPTIONS = '--openssl-legacy-provider'; // 应用程序其余部分... ``` 这样做的好处在于只影响当前的应用实例而不干扰其他可能正在运行的服务[^2]。 #### 方法三:全局配置 为了使更改生效范围更大,可以选择将上述选项写入操作系统的环境变量中去。具体做法取决于操作系统类型: - **Linux/macOS**: 编辑 `.bashrc`, `.zshrc` 等 shell 配置文件; - **Windows**: 使用“高级系统设置”中的“环境变量”。 需要注意的是,虽然这些方法能够有效解决问题,但从长远来看还是推荐升级相关依赖项以获得更好的兼容性和安全性[^3]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

所遇所思

你的鼓励将是我的原动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值