如何解决simple-react-lightbox相关npm ERESOLVE依赖树错误

这是npm 7及以上版本默认开启严格peer依赖校验触发的报错：你的项目使用React 18.1.0，但引入的simple-react-lightbox@3.6.9-0声明的peer依赖仅支持React ^17.0.2，版本不匹配导致依赖树解析失败。
本地gatsby build能正常跑，基本是本地依赖缓存、旧版npm默认宽松校验，或者之前安装依赖时用过跳过校验的参数导致的；Netlify构建环境每次都是全新拉取依赖走严格校验规则，所以会直接构建失败。

1. 替换为兼容React 18的维护中库（最优长期方案） #

simple-react-lightbox目前已经停止维护，最高适配的React版本就是17，就算临时跳过版本校验，后续Gatsby升级、React版本迭代时很容易出现运行时兼容问题。
可以直接替换为Gatsby生态适配良好、原生支持React 18的灯箱组件，比如yet-another-react-lightbox，API设计和simple-react-lightbox接近，迁移成本很低，没有长期版本隐患。

2. 通过npm overrides精准解决版本冲突（不换库的首选方案） #

这个方案可以定向覆盖指定包的peer依赖声明，不会全局跳过所有依赖校验，比暴力加安装参数稳妥很多：

1. 打开项目根目录的package.json，新增如下配置：

{
  "overrides": {
    "simple-react-lightbox": {
      "react": "$react",
      "react-dom": "$react-dom"
    }
  }
}

配置里的$react代表直接复用根项目声明的React版本，不用手动写死版本号，后续升级React时会自动同步。如果本地npm版本低于8.3，直接把$react、$react-dom替换成项目实际使用的React版本号即可，比如"^18.1.0"。
2. 删除本地的node_modules文件夹和package-lock.json文件，重新执行npm install安装依赖。
3. 本地完整测试灯箱组件的打开、关闭、翻页、缩放等所有交互，确认没有运行时报错后再推送代码到Netlify，构建时会自动读取overrides配置，不会再触发依赖报错。

3. 配置Netlify构建参数跳过peer校验（临时应急方案） #

如果需要快速上线不想改动依赖配置，可以给Netlify的npm安装流程加跳过peer校验的参数：

1. 进入Netlify站点后台，打开「站点设置」-「构建&部署」-「环境变量」配置页
2. 新增环境变量：键为NPM_FLAGS，值为--legacy-peer-deps
3. 重新触发构建即可通过。
   注意：这个方案会全局跳过所有包的peer依赖校验，后续新增依赖出现版本冲突时很难定位问题，仅适合临时应急使用。

不要直接使用npm install --force强制安装依赖，这个参数会暴力覆盖依赖树中其他包的版本要求，很容易出现本地运行正常、线上白屏或者组件功能异常的隐性问题。

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