nodejs18版本 npm run dev失败

简介: 在使用若依框架运行 `npm run dev` 时,若卡在 95% 并报错,通常是 Node.js 17+ 与 Webpack 的兼容性问题。原因是 OpenSSL 3 的加密算法变化导致依赖冲突。解决方法:Windows 下运行 `set NODE_OPTIONS=--openssl-legacy-provider`,macOS/Linux 使用 `export NODE_OPTIONS=--openssl-legacy-provider`,然后重新启动开发服务即可。此设置让 Node.js 启用旧版加密支持,恢复正常构建流程。

theme: cyanosis

在我搭建若依框架的时候,npm run dev搭建服务时总是卡在95%之后爆红。经过排查发现,输入命令

set NODE_OPTIONS=--openssl-legacy-provider

问题解决。

nodejs.jpg

问题现象

执行 npm run dev 时,终端会卡在类似 95% emitting95% module build 之类的进度信息,然后报错。这个问题通常发生在使用 Node.js 17 或更高版本的时候。

问题分析

导致这个问题的核心原因是 Node.js 和 Webpack 之间的兼容性问题。具体来说:

  • 从 Node.js 17 开始,Node.js 默认使用 OpenSSL 3 来处理加密操作,而 OpenSSL 3 对一些旧的加密方法和算法的支持发生了变化。许多前端框架,如 Vue.js 和 React.js,在使用 Webpack 进行模块打包和热替换时,可能依赖于这些旧的加密方法。
  • Webpack 及其插件或依赖项在处理加密时,可能使用了 OpenSSL 的旧版本算法。如果这些插件或模块没有更新,导致与 OpenSSL 3 不兼容,从而导致运行时报错。

为什么这个命令可以解决问题?

当你执行 set NODE_OPTIONS=--openssl-legacy-provider 时,这一命令的作用是告诉 Node.js 使用 OpenSSL 的“旧版加密提供程序”(legacy provider)。它会让 Node.js 重新启用对旧版加密算法的支持,从而解决与 Webpack 或其他依赖项的兼容性问题。

简单来说,这一设置相当于让 Node.js 回到之前支持旧加密算法的模式,这样就不会再因为 OpenSSL 版本的变化而导致报错。

具体步骤

  1. 在项目根目录下,打开终端或命令行工具。

  2. 输入以下命令:

    set NODE_OPTIONS=--openssl-legacy-provider
    

    注意:如果你使用的是 macOS 或 Linux,命令格式应为:

    export NODE_OPTIONS=--openssl-legacy-provider
    
  3. 再次运行 npm run dev,你会发现问题已经解决,项目可以正常启动。

如果在若依框架或其他基于 Vue.js 的前端项目中遇到 npm run dev 卡在 95% 之后报错的问题,多半是因为 Node.js 和 Webpack 之间的兼容性问题。通过设置 NODE_OPTIONS=--openssl-legacy-provider 可以让 Node.js 兼容旧版的加密方式,从而解决这个问题。

目录
相关文章
|
8月前
|
存储 JavaScript 前端开发
在NodeJS中使用npm包进行JS代码的混淆加密
总的来说,使用“javascript-obfuscator”包可以帮助我们在Node.js中轻松地混淆JavaScript代码。通过合理的配置,我们可以使混淆后的代码更难以理解,从而提高代码的保密性。
750 9
|
8月前
|
JavaScript 算法 前端开发
解决若依框架中 npm run dev 卡在 95% 的问题
本文深入探讨若依框架中 `npm run dev` 卡在 95% 的问题,分析其与 Node.js 17+ 内置 OpenSSL 3.0 加密策略变更的关系。提供临时(设置环境变量 `NODE_OPTIONS=--openssl-legacy-provider`)和永久(修改 `package.json` 脚本)解决方案,同时建议降级 Node.js 或更新依赖以根本解决兼容性问题。最后强调依赖管理与开发环境标准化的重要性,助力团队高效开发。
806 1
|
11月前
|
JavaScript
nodejs安装之npm ERR! code CERT_HAS_EXPIREDnpm ERR! errno CERT_HAS_EXPIRED reason: certificate has expired-证书错误通用问题解决方案-优雅草央千澈
nodejs安装之npm ERR! code CERT_HAS_EXPIREDnpm ERR! errno CERT_HAS_EXPIRED reason: certificate has expired-证书错误通用问题解决方案-优雅草央千澈
1766 27
|
11月前
node环境之当我们遇到需要付费的依赖库@fortawesome/fontawesome-pro导致npm install无法进行怎么办-fontawesome-pro依赖库
node环境之当我们遇到需要付费的依赖库@fortawesome/fontawesome-pro导致npm install无法进行怎么办-fontawesome-pro依赖库
308 3
node环境之当我们遇到需要付费的依赖库@fortawesome/fontawesome-pro导致npm install无法进行怎么办-fontawesome-pro依赖库
|
11月前
|
存储 资源调度 JavaScript
npm、cnpm 和 pnpm 是三种常用的 Node.js 包管理工具
npm、cnpm 和 pnpm 是三种常用的 Node.js 包管理工具。npm 是官方默认的包管理器,提供依赖管理、安装和更新等功能;cnpm 是由阿里巴巴开发的 npm 镜像,专为中国大陆用户优化,解决下载速度慢的问题;pnpm 通过硬链接技术提高安装速度并节省磁盘空间,特别适合磁盘资源紧张的环境。三者命令类似,但各有特色,开发者可根据需求选择合适的工具。
1137 5
|
5月前
|
JavaScript Unix Linux
nvm与node.js的安装指南
通过以上步骤,你可以在各种操作系统上成功安装NVM和Node.js,从而在不同的项目中灵活切换Node.js版本。这种灵活性对于管理不同项目的环境依赖而言是非常重要的。
1154 11
|
10月前
|
弹性计算 JavaScript 前端开发
一键安装!阿里云新功能部署Nodejs环境到ECS竟然如此简单!
Node.js 是一种高效的 JavaScript 运行环境,基于 Chrome V8 引擎,支持在服务器端运行 JavaScript 代码。本文介绍如何在阿里云上一键部署 Node.js 环境,无需繁琐配置,轻松上手。前提条件包括 ECS 实例运行中且操作系统为 CentOS、Ubuntu 等。功能特点为一键安装和稳定性好,支持常用 LTS 版本。安装步骤简单:登录阿里云控制台,选择扩展程序管理页面,安装 Node.js 扩展,选择实例和版本,等待创建完成并验证安装成功。通过阿里云的公共扩展,初学者和经验丰富的开发者都能快速进入开发状态,开启高效开发之旅。
|
9月前
|
资源调度 JavaScript 前端开发
前端开发必备!Node.js 18.x LTS保姆级安装教程(附国内镜像源配置)
本文详细介绍了Node.js的安装与配置流程,涵盖环境准备、版本选择(推荐LTS版v18.x)、安装步骤(路径设置、组件选择)、环境验证(命令测试、镜像加速)及常见问题解决方法。同时推荐开发工具链,如VS Code、Yarn等,并提供常用全局包安装指南,帮助开发者快速搭建高效稳定的JavaScript开发环境。内容基于官方正版软件,确保合规性与安全性。
7915 23
|
10月前
|
JavaScript 前端开发 数据可视化
【01】Cocos游戏开发引擎从0开发一款游戏-cocos环境搭建以及配置-Cocos Creator软件系统下载安装-node环境-优雅草卓伊凡
【01】Cocos游戏开发引擎从0开发一款游戏-cocos环境搭建以及配置-Cocos Creator软件系统下载安装-node环境-优雅草卓伊凡
597 2
【01】Cocos游戏开发引擎从0开发一款游戏-cocos环境搭建以及配置-Cocos Creator软件系统下载安装-node环境-优雅草卓伊凡
|
10月前
|
弹性计算 JavaScript 前端开发
一键安装!阿里云新功能部署Nodejs环境到ECS竟然如此简单!
一键安装!阿里云新功能部署Nodejs环境到ECS竟然如此简单!
一键安装!阿里云新功能部署Nodejs环境到ECS竟然如此简单!

热门文章

最新文章

推荐镜像

更多
  • NPM