You need to enable JavaScript to run this app. GitHub部署应用到Heroku报错fsevents not accessible from jest-haste-map如何解决
优惠活动
大模型
产品
解决方案
定价
更多

GitHub部署应用到Heroku报错fsevents not accessible from jest-haste-map如何解决

Heroku部署报错 fsevents not accessible from jest-haste-map 解决方案

错误根因

fsevents是仅适配macOS系统的可选依赖,作用是监听macOS下的文件系统变化,Heroku的运行环境为Linux容器,本身不需要安装该包。你遇到的报错是你使用的react-scripts@4.0.3版本内置的jest相关依赖,在生产环境安装依赖时异常触发了可选依赖的校验逻辑导致的。


方案1:配置npm跳过可选依赖安装(推荐,改动最小)

在项目根目录新建.npmrc文件,写入以下内容:

optional = false

该配置会让npm在所有环境下都跳过安装可选依赖,从根源避免fsevents被解析安装的问题。改完后将文件提交到GitHub,重新触发Heroku部署即可。

方案2:调整依赖包分类(次推荐,同时减小生产依赖体积)

你当前把测试相关的开发依赖都放在了生产依赖dependencies字段下,这些包生产环境完全不需要使用,将它们挪到devDependencies字段即可,需要挪动的包包括:

  • @testing-library/jest-dom
  • @testing-library/react
  • @testing-library/user-event
  • web-vitals

调整后的package.json结构参考:

{
  "name": "app-clean",
  "version": "0.1.0",
  "private": true,
  "main": "index.js",
  "dependencies": {
    "@reduxjs/toolkit": "^1.6.0",
    "bootstrap": "^5.0.1",
    "bootstrap-icons": "^1.5.0",
    "json-server": "^0.16.3",
    "react": "^17.0.2",
    "react-dom": "^17.0.2",
    "react-redux": "^7.2.4",
    "react-scripts": "4.0.3"
  },
  "devDependencies": {
    "@testing-library/jest-dom": "^5.11.4",
    "@testing-library/react": "^11.1.0",
    "@testing-library/user-event": "^12.1.10",
    "web-vitals": "^1.0.1"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject",
    "server": "json-server db.json -p 5000 -w -d 0"
  },
  "eslintConfig": {
    "extends": [
      "react-app",
      "react-app/jest"
    ]
  },
  "browserslist": {
    "production": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  }
}

调整后提交代码重新部署即可,Heroku默认安装依赖时不会拉取devDependencies下的包,自然不会触发测试相关依赖的fsevents解析逻辑。

方案3:升级react-scripts版本

如果前两个方案都不适用,可以将react-scripts升级到5.0.0以上版本,该版本官方已经修复了jest依赖的可选依赖解析问题,执行以下命令升级即可:
npm install react-scripts@latest
升级后提交代码重新部署即可。


内容的提问来源于stack exchange,提问作者Nguyễn Ngọc Hải

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 08:36:04