如何解决将Node与React应用部署到Heroku时的fsevents平台不兼容报错？

fsevents是仅兼容macOS（darwin）平台的专属文件系统监听依赖，不会出现在你直接声明的生产或开发依赖列表中，通常是react-scripts、webpack、chokidar这类前端工具链的传递可选依赖。
npm的原生设计逻辑是：遇到和当前运行平台不匹配的可选依赖时，会自动跳过安装。但如果你生成项目锁文件package-lock.json时的本地环境是macOS，锁文件会强制写入fsevents的安装条目，推送到Heroku的Linux x64运行环境时，就会触发EBADPLATFORM平台不兼容报错。

• 方案1（长期生效、无额外风险）
  在你的frontend目录下新建.npmrc配置文件，写入单行配置：

  optional=false
  

  这个配置会让npm在安装依赖时，自动跳过所有和当前运行平台不匹配的可选依赖，从根源上不会触发fsevents的平台校验，也不会破坏原有依赖的版本锁定关系。不管后续在哪个系统本地安装依赖，推送到Heroku都不会复现同类的平台不匹配报错。
• 方案2（修正锁文件状态）
  如果你之前在macOS环境下生成了项目锁文件，直接删除frontend目录下的node_modules文件夹和package-lock.json文件，重新在本地执行npm install生成全新的锁文件，再将更新后的文件提交到Git仓库推送部署即可。新生成的锁文件会自动过滤Linux环境下不需要安装的fsevents条目。
• 方案3（快速临时调整）
  如果你不想修改本地项目文件，可以直接调整Heroku的前端构建命令，在原有安装命令中增加参数跳过可选依赖安装，把原来的：

  NPM_CONFIG_PRODUCTION=false npm install --prefix frontend && npm run build --prefix frontend
  

  替换为：

  NPM_CONFIG_PRODUCTION=false npm install --prefix frontend --omit=optional && npm run build --prefix frontend
  

  新增的--omit=optional参数会让npm安装阶段完全跳过可选依赖安装，不会触发fsevents的平台校验逻辑。

避坑提示：不要手动硬删package-lock.json里的fsevents条目，这种操作很容易破坏锁文件的哈希校验，导致其他关联依赖出现版本错乱的问题。

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