运行Node.js应用时如何提示用户当前Node.js引擎版本不符合要求？

结论 #

engines配置默认只能在依赖安装阶段触发校验，无法直接阻止不符合版本要求的环境启动你的应用，你遇到的现象是符合npm官方设计的。

具体说明 #

• engines字段的设计初衷是标注包兼容的Node.js版本范围，默认情况下执行npm install/yarn install时如果环境版本不匹配，只会输出警告日志，不会终止安装流程。
• 如果需要让依赖安装阶段版本不匹配就直接报错终止，可以在项目根目录新建.npmrc文件，添加以下配置：

  engine-strict = true
  

  该配置仅对依赖安装环节生效，仍不会影响npm run start等自定义脚本的执行。

启动时校验的实现方案 #

如果要实现启动时自动校验Node版本、不符合就终止运行，可以用以下两种方案：

方案1：通过前置脚本钩子实现（推荐，无需修改业务代码）

1. 安装版本校验工具到开发依赖：

   npm i check-node-version -D
   

2. 修改package.json的scripts配置，新增prestart钩子：

   "scripts": {
     "prestart": "check-node-version --node '^14'",
     "start": "你原来的启动命令"
   }
   

   npm会自动在执行start命令前先执行prestart对应的脚本，版本不匹配时会直接报错退出，不会运行后续的启动逻辑。

方案2：在业务代码入口添加校验逻辑

在你应用的入口文件最顶部添加以下代码即可：

const currentNodeVersion = process.versions.node
const requiredMajorVersion = 14
const currentMajorVersion = parseInt(currentNodeVersion.split('.')[0], 10)

if (currentMajorVersion < requiredMajorVersion) {
  console.error(`错误：当前Node.js版本为${currentNodeVersion}，本应用要求Node.js版本 >=14，请升级版本后再启动。`)
  process.exit(1)
}

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