安装bpmn.io form-js时npm误识别Node版本问题求助

问题背景 #

尝试用npm install安装bpmn.io的form-js包，该包要求环境为Node 16和npm 8。通过nvm切换到对应版本后，执行node -v和npm -v显示：

v16.20.2
8.19.4

但运行npm install时，npm却识别当前Node版本为12，抛出引擎不兼容警告，后续还出现语法错误（可选链操作符?.不被支持）。

错误信息 #

引擎不兼容警告 #

npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'minimatch@9.0.4',
npm WARN EBADENGINE   required: { node: '>=16 || 14 >=14.17' },
npm WARN EBADENGINE   current: { node: 'v12.22.9', npm: '8.19.4' }
npm WARN EBADENGINE }
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'styled-components@6.1.11',
npm WARN EBADENGINE   required: { node: '>= 16' },
npm WARN EBADENGINE   current: { node: 'v12.22.9', npm: '8.19.4' }
npm WARN EBADENGINE }
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'rollup-plugin-css-only@4.5.2',
npm WARN EBADENGINE   required: { node: '>=14' },
npm WARN EBADENGINE   current: { node: 'v12.22.9', npm: '8.19.4' }
npm WARN EBADENGINE }

后续语法错误 #

npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'rollup-plugin-css-only@4.5.2',
npm WARN EBADENGINE   required: { node: '>=14' },
npm WARN EBADENGINE   current: { node: 'v12.22.9', npm: '8.19.4' }
npm WARN EBADENGINE }
npm WARN deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm WARN deprecated read-package-json@6.0.4: This package is no longer supported. Please use @npmcli/package-json instead.
npm WARN deprecated read-package-json@7.0.1: This package is no longer supported. Please use @npmcli/package-json instead.
npm WARN deprecated npmlog@6.0.2: This package is no longer supported.
npm WARN deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm WARN deprecated are-we-there-yet@3.0.1: This package is no longer supported.
npm WARN deprecated glob@8.1.0: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated gauge@4.0.4: This package is no longer supported.
npm ERR! code 1
npm ERR! path /home/okaeiz/Camunda/form-js/node_modules/nx
npm ERR! command failed
npm ERR! command sh -c -- node ./bin/post-install
npm ERR! /home/okaeiz/Camunda/form-js/node_modules/nx/src/project-graph/project-graph.js:119
npm ERR!         ...(projectConfigurationsError?.errors ?? []),
npm ERR!                                        ^
npm ERR!
npm ERR! SyntaxError: Unexpected token '.'
npm ERR!     at wrapSafe (internal/modules/cjs/loader.js:915:16)
npm ERR!     at Module._compile (internal/modules/cjs/loader.js:963:27)
npm ERR!     at Object.Module._extensions..js (internal/modules/cjs/loader.js:1027:10)
npm ERR!     at Module.load (internal/modules/cjs/loader.js:863:32)
npm ERR!     at Function.Module._load (internal/modules/cjs/loader.js:708:14)
npm ERR!     at Module.require (internal/modules/cjs/loader.js:887:19)
npm ERR!     at require (internal/modules/cjs/helpers.js:74:18)
npm ERR!     at Object.<anonymous> (/home/okaeiz/Camunda/form-js/node_modules/nx/bin/post-install.js:3:25)
npm ERR!     at Module._compile (internal/modules/cjs/loader.js:999:30)
npm ERR!     at Object.Module._extensions..js (internal/modules/cjs/loader.js:1027:10)

npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2024-06-06T08_08_02_495Z-debug-0.log

已尝试的操作 #

• 切换Node版本后清理缓存：

  npm cache clean --force
  rm -rf node_modules
  rm package-lock.json
  

• 配置PATH环境变量确保使用nvm安装的Node版本：

  export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" bash_completion
  

• 重启系统，但问题依旧。

问题原因分析 #

核心问题是当前终端/执行环境实际使用的Node版本是12，但手动查询时用的是nvm切换后的Shell环境，可能的触发场景：

1. 在普通用户Shell里切换了nvm版本，但执行npm install时用了sudo，sudo会重置环境变量，使用系统默认的Node 12；
2. 终端窗口没有重新加载nvm配置（比如修改bashrc/zshrc后没重启终端，或者当前Shell没执行source ~/.bashrc）；
3. 系统中存在全局安装的Node版本，优先级高于nvm的版本；
4. IDE/编辑器的终端没有继承nvm的环境配置，比如VS Code需要重启才能加载新的环境变量。

解决方案 #

方案1：避免使用sudo执行npm命令 #

如果之前用sudo npm install，换成普通用户权限执行：

npm install

（如果权限不足，可修改npm全局目录权限，避免用sudo：mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'，然后把~/.npm-global/bin加入PATH）

方案2：确保当前Shell正确加载nvm #

1. 执行以下命令重新加载nvm配置：

   source ~/.nvm/nvm.sh
   

2. 再次确认版本：

   node -v && npm -v
   

3. 若每次打开终端都需要手动加载，把nvm配置加入Shell配置文件（比如~/.bashrc或~/.zshrc）：

   echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
   echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
   echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrc
   

   然后重启终端或执行source ~/.bashrc。

方案3：检查系统全局Node版本并处理 #

1. 查看系统全局Node的路径：

   which node
   

   如果输出不是~/.nvm/versions/node/v16.20.2/bin/node，说明系统有全局Node。
2. 卸载系统全局Node（以Ubuntu为例）：

   sudo apt remove nodejs npm
   

   之后重新加载nvm：source ~/.nvm/nvm.sh，再确认版本。

方案4：检查IDE终端环境 #

如果是在IDE（比如VS Code）里执行命令，重启IDE，确保它加载了最新的环境变量。也可以在IDE终端里手动执行source ~/.nvm/nvm.sh切换版本后再安装。

方案5：强制指定Node版本（临时应急） #

如果以上方法都无效，可以临时跳过引擎检查（不推荐，可能引发其他问题）：

npm install --ignore-engines

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