Node 16.2.0安装@testing-library/jest-dom报EBADENGINE错误如何解决

报错直接原因是.npmrc中engine-strict=true配置开启后，npm会严格校验所有依赖（含传递依赖）的Node版本要求，不满足就直接终止安装：

• 触发报错的包是jest-matcher-utils@28.1.1，它要求Node版本满足^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0
• 你当前运行的Node版本是v16.2.0，不满足16.x分支最低16.10.0的要求，因此安装被阻断。
  你之前单独卸载jest没有效果，是因为这个高版本的jest-matcher-utils不是你直接安装的jest@26.6.3带来的，而是@testing-library/jest-dom@^5.16.2拉取的传递依赖。

按推荐优先级从高到低排列：

方案1：升级Node版本（无兼容性风险，首选） #

将本地Node版本升级到符合依赖要求的版本即可。如果你要继续使用16.x大版本，直接升级到16.10.0以上的16.x维护版（比如16.20.2）即可，不会存在大版本 breaking change。升级完成后重新执行npm install即可正常安装。

方案2：关闭engine严格校验（快速临时解决） #

如果暂时不方便升级Node，可以修改.npmrc配置跳过版本校验，操作步骤：

• 打开项目根目录的.npmrc文件
• 将engine-strict=true修改为engine-strict=false
• 保存后重新执行npm install

注意： 该方案仅跳过安装阶段的版本校验，若jest-matcher-utils@28.1.1使用了v16.2.0未实现的API，后续运行测试时可能出现运行时错误。

方案3：强制锁定传递依赖版本 #

如果既不想升级Node，也不想关闭engine严格校验，可以通过npm的overrides配置强制所有依赖使用兼容v16.2.0的jest-matcher-utils版本，操作步骤：

• 打开项目根目录的package.json文件
• 在顶层新增overrides字段：

{
  "overrides": {
    "jest-matcher-utils": "^27.5.1"
  }
}

• 删除残留的node_modules目录和package-lock.json文件，重新执行npm install

该配置会强制整个依赖树中的jest-matcher-utils都使用27.x版本，该版本的Node引擎要求兼容v16.2.0，不会触发EBADENGINE报错。

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