【前端笔记】npm报错ERR_OSSL_EVP_UNSUPPORTED

于离别之朝束起约定之花

已于 2023-10-11 17:21:26 修改

阅读量4.5k

点赞数 3

文章标签：前端笔记

于 2023-07-25 15:59:35 首次发布

本文链接：https://blog.csdn.net/qq_43398736/article/details/131919865

版权

文章讲述了在Node.js版本17.x中由于OpenSSL3.0的限制导致的报错问题，包括error:0308010C:digitalenveloperoutines::unsupported和error:03000086:digitalenveloperoutines::initializationerror。解决方法包括降级Node版本至16.x或者设置环境变量NODE_OPTIONS=--openssl-legacy-provider。对于项目打包部署时遇到相同问题且使用了crypto加密库的情况，可以通过修改crypto.createHash方法来规避问题。

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

报错原因

Node版本>=17.x，本地npm run 起项目后会发现终端报错，具体有以下2块关键信息：

Error: error:0308010C:digital envelope routines::unsupported

和

opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'

根本原因

原因是node v17中的OpenSSL3.0对允许算法和密钥大小增加了严格的限制。此处查看详情

解决办法

1、node版本降级为16.x

既然是版本问题，最简单粗暴的办法就是降级

2、设置环境变量

在终端手动修改环境变量，输入下面的内容：

export NODE_OPTIONS=--openssl-legacy-provider

然后重新启动项目，就不会失败了。

为什么这个办法能解决，因为在上面的根本原因放的链接里面就已经有答案了，如下图：

在这里插入图片描述

2023-07-27更新：

上面的内容只是解决了本地启动时的问题，如果项目打包部署也出现了这个问题，并且项目中使用到了crypto加密库，可以尝试使用下面的配置：

// vue.config.js or webpack.config.js
const crypto = require('crypto');
const crypto_orig_createHash = crypto.createHash;
crypto.createHash = algorithm => crypto_orig_createHash(algorithm === 'md4' ? 'sha256' : algorithm);

其他修复方法