React18安装redux-react-session报ERESOLVE依赖冲突如何解决

问题根因 #

npm 7及以上版本默认开启严格peer依赖校验，当前项目使用React 18.1.0，而redux-react-session@2.6.1最后一次发版是2019年，官方标注兼容的React版本范围最高到16.x，版本校验不通过就会抛出ERESOLVE依赖树解析失败错误。

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

• 方案1：加--legacy-peer-deps参数安装（首选）
  这个参数会让npm沿用v6版本的宽松依赖解析逻辑，跳过严格的peer依赖校验，不会强制改动项目里已有的其他依赖版本，风险最低。执行命令：

  npm i redux-react-session --legacy-peer-deps
  

  不想每次装包都加参数的话，可以在项目根目录新建.npmrc文件，写入一行配置永久生效：

  legacy-peer-deps=true
  

  实际运行层面redux-react-session没有用到React 16以上废弃的API，装完基本都能正常跑，如果启动后真的出现兼容性报错再换其他方案就行。

• 方案2：强制安装
  执行带--force参数的安装命令，强制npm忽略所有冲突安装目标包：

  npm i redux-react-session --force
  

  注意：这个操作可能会覆盖项目里已有的部分依赖版本，有可能导致其他组件运行异常，不推荐优先使用。

• 方案3：换用维护状态正常的同功能包（长期最优）
  redux-react-session已经停更多年，后续不会适配React 17/18新版本，长期做项目建议换社区主流方案：

  • 自己写简单的Redux状态持久化逻辑，对接sessionStorage/localStorage，代码量很小，完全可控
  • 用redux-persist做Redux状态持久化，这个包一直在维护，原生兼容React 18，不会有依赖冲突问题

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