Windows 10 64位系统使用npm安装Cypress提示找不到har-validator模块报错

报错场景 #

升级安装Cypress 9.1版本，或回装8.7版本时，执行npm install --save-dev cypress相关命令均出现如下报错：

npm ERR! Error: Cannot find module 'har-validator'

前置操作已删除项目中的node_modules、package-lock.json文件，并移除了package.json中原有的"cypress": "^8.7.0"依赖项。

环境信息 #

node -v
# 输出 v16.8.0
npm -v
# 输出 7.21.0

根因说明 #

该报错由两方面因素共同触发：一是2021年前后har-validator包曾被官方临时下架，导致依赖该包的安装链路中断；二是npm 7.x版本的扁平化依赖解析逻辑和旧版本Cypress的依赖声明存在兼容性问题。

解决方案 #

• 方案1：清理npm全局缓存后重新安装
  执行命令清理缓存：

  npm cache clean --force
  

  清理完成后再次执行对应版本的安装命令即可，例：

  # 安装8.7.0版本
  npm install --save-dev cypress@8.7.0
  # 安装9.1.0版本
  npm install --save-dev cypress@9.1.0
  

• 方案2：降级npm版本到6.x
  npm 6.x的依赖解析逻辑不会触发该兼容性问题，执行全局降级命令：

  npm install -g npm@6
  

  降级完成后再执行Cypress安装命令即可。
• 方案3：更换包管理器为yarn
  yarn的依赖解析逻辑不受该问题影响，安装yarn后执行以下命令即可：

  yarn add cypress --dev
  

相关更新 #

• 相同场景下，OSX系统搭配nodejs 14.16.0版本，通过package.json配置8.7.0依赖可正常安装。
• 截至2021年11月26日，npm官方镜像已恢复相关依赖包的缓存，直接执行npm install --save-dev cypress@8.7.0即可正常安装。

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