Heroku部署失败：无法加载eslint-plugin-cypress插件问题排查

我之前也碰到过类似的部署坑，结合你提供的信息，咱们来理清楚问题根源和可行的解决办法：

问题核心原因 #

报错Failed to load plugin 'cypress' declared in 'package.json': Cannot find module 'eslint-plugin-cypress'本质上是Heroku构建阶段没有安装devDependencies里的eslint-plugin-cypress，尽管官方文档说构建时会安装所有依赖，但实际有两个关键点导致了这个问题：

1. NPM默认的production模式会跳过devDependencies安装，Heroku默认可能隐式开启了这个模式；
2. Cypress 6.0.0的postinstall钩子需要在非production模式下才能运行，失败日志里完全没看到这个钩子的执行记录，说明依赖安装阶段根本没处理Cypress相关的dev依赖。

你提到之前的构建能成功，主要是因为旧版本的react-scripts（3.4.3）对ESLint的集成校验没那么严格，而且Cypress 5.4.0的安装逻辑没有6.x版本的限制。

可行解决方案（按推荐优先级排序） #

1. 强制Heroku安装所有依赖（已验证有效） #

你已经通过heroku config:set NPM_CONFIG_PRODUCTION=false解决了问题，这个命令会让npm在安装阶段包含devDependencies，这样eslint-plugin-cypress和Cypress的完整依赖都会被安装，ESLint就能正常读取插件配置了。

如果想避免每次手动设置环境变量，可以在项目根目录创建一个.npmrc文件，添加一行：

production=false

Heroku构建时会自动读取这个配置，持久化生效。

2. 将eslint-plugin-cypress移到dependencies #

如果不想全局关闭production模式，只需要把eslint-plugin-cypress从devDependencies移到dependencies里，这样Heroku默认会安装它，既不影响IDE的Cypress功能，也能解决构建报错。修改后的package.json片段：

"dependencies": {
  "@testing-library/jest-dom": "^5.11.6",
  "@testing-library/react": "^11.2.2",
  "@testing-library/user-event": "^12.2.2",
  "react": "^17.0.1",
  "react-dom": "^17.0.1",
  "react-scripts": "^4.0.1",
  "eslint-plugin-cypress": "^2.11.2" // 移到这里
},
"devDependencies": {
  "@testing-library/cypress": "^7.0.2",
  "cypress": "^6.0.0" // 移除原来的eslint-plugin-cypress
}

3. 在构建前手动安装dev依赖 #

可以修改package.json的脚本，在build前先安装dev依赖：

"scripts": {
  "start": "react-scripts start",
  "prebuild": "npm install --only=dev",
  "build": "react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject",
  "cypress:open": "cypress open",
  "cypress:run": "cypress run"
}

不过这个方案会增加构建时间，因为要额外执行一次依赖安装，优先级低于前两个方案。

后续排查小技巧 #

如果以后再碰到类似的依赖问题，可以试试这些方法：

• 查看Heroku构建日志里的npm install输出，确认devDependencies是否被安装；
• 临时在build脚本里添加依赖检查，比如：

  "build": "npm list eslint-plugin-cypress && react-scripts build"
  

  这样能快速确认依赖是否安装成功；
• 运行heroku config查看当前环境变量，确认NPM_CONFIG_PRODUCTION和NODE_ENV的取值。

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