Jenkins部署报错The engine “node“ is incompatible with this module.

原创已于 2025-03-08 11:30:39 修改 · 2.4k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #jenkins

于 2023-12-27 15:52:17 首次发布

本文讲述了在Jenkins部署前端项目时遇到的Node.js版本不匹配问题，通过卸载旧版本并重装指定版本，以及使用yarnconfigsetignore-enginestrue命令忽略引擎检查，解决依赖安装报错，确保项目成功部署。

报错截图

在这里插入图片描述

问题描述

通过 Jenkins 部署前端项目时，在安装依赖时报错导致项目无法部署成功。

原因分析

通过控制台输出不难看出报错的原因是因为 Jenkins 部署的项目使用了不兼容的模块版本导致的问题。具体来说，错误信息显示项目中需要使用 Node.js 版本 14 || >=16.14，但系统中安装的 Node.js 版本为 16.13.2。

解决方案

一、卸载 node 并重装指定版本

node 以往版本的下载地址

在这里插入图片描述

二、忽略错误后重新执行 yarn install 命令

2.1 首先进入配置页面。

在这里插入图片描述

2.2 找到构建将 yarn config set ignore-engines true 命令放在 yarn install 命令之前即可。

在这里插入图片描述

yarn config set ignore-engines true 命令

yarn config set ignore-engines true 命令，用于设置 yarn 在安装依赖时忽略引擎检查。在 Node.js 项目中，某些模块可能会指定它们所需的 Node.js 版本范围。当使用 yarn 安装依赖项时，yarn 会检查这些模块的引擎要求，并确保 Node.js 版本符合要求。如果你的 Node.js 版本不符合要求，yarn 会阻止安装这些模块，并显示引擎不匹配的错误。通过运行 yarn config set ignore-engines true 命令，你可以将 yarn 的配置设置为忽略引擎检查。这意味着即使您的 Node.js 版本与某些模块的要求不匹配，yarn 仍会继续安装这些模块，而不会中断安装过程。