ProcessMaker 4开发安装时NPM出现EBADENGINE错误

问题重现 #

执行npm install时出现以下错误：

npm ERR! code EBADENGINE
npm ERR! engine Unsupported engine
npm ERR! engine Not compatible with your version of node/npm: @processmaker/processmaker@4.4.0-RC1
npm ERR! notsup Not compatible with your version of node/npm: @processmaker/processmaker@4.4.0-RC1
npm ERR! notsup Required: {"npm":"~8","node":">=16.18 >19"}
npm ERR! notsup Actual: {"npm":"8.19.2","node":"v18.12.1"}

实际版本明明符合要求，修改package.json后也未生效，环境为Windows 10 + XAMPP。

解决方案 #

• 确认修改的package.json位置：必须修改项目根目录下的package.json，而非node_modules子文件夹里的依赖文件。很多人会误改子包配置导致无效。
• 清理缓存并重装：
  1. 执行npm cache clean --force清空npm缓存
  2. 删除项目根目录下的node_modules文件夹和package-lock.json文件
  3. 重新运行npm install
• 跳过引擎检查（临时方案）：
  • 直接带参数执行：npm install --legacy-peer-deps（优先选这个，避免依赖冲突），或者npm install --force
  • 永久设置：在项目根目录新建.npmrc文件，写入engine-strict=false，之后正常执行npm install
• 检查环境变量冲突：打开命令提示符执行node -v和npm -v，确认输出的版本是你预期的18.12.1和8.19.2，避免XAMPP自带的Node版本干扰全局环境。

内容的提问来源于stack exchange，提问作者Arturo