connected-react-router不兼容React 18的报错及替代方案咨询

报错直接原因 #

安装失败是npm peer依赖校验拦截导致：connected-react-router@6.9.2 声明的对等依赖仅覆盖React 16.4.0 ~ 17.x版本范围，未声明对React 18的兼容支持，npm 7及以上版本默认会严格校验对等依赖匹配性，因此抛出如下冲突错误：

npm ERR! Found: react@18.1.0
npm ERR! node_modules/react
npm ERR! react@"^18.1.0" from the root project
npm ERR!
npm ERR! Could not resolve dependency
npm ERR! peer react@"^16.4.0 || ^17.0.0" from connected-react-router@6.9.2

关于 connected-react-router 的维护状态 #

该库目前已基本停滞维护：

• 核心代码长期无更新，大量适配React 18、React Router v6的社区PR长期未被合并，官方从未发布支持React 18的正式稳定版本，不建议在全新的React 18项目中引入。

React 18 下连接路由与Redux Store的可用方案 #

React 18 本身没有内置路由与Redux状态同步的能力，目前有三类成熟方案可选：

• 首选社区维护的活跃替代包redux-first-history：该库是目前Redux生态下适配最完善的connected-react-router替代方案，完美兼容React 18、React Router v6、Redux Toolkit，支持路由状态同步到Store、通过dispatch action触发跳转、路由变更副作用监听等全部核心能力，无依赖冲突问题，也是Redux Toolkit文档中提及的路由同步推荐方案。
• 临时兼容方案：如果项目仍在使用React Router v5，不想替换现有依赖，可以在安装时添加--legacy-peer-deps参数跳过对等依赖校验强制安装，经社区大量项目验证，connected-react-router 6.9.2版本在React 18环境下可正常运行，但该方式存在潜在兼容风险，不推荐作为长期方案使用。
• 轻量手动实现：如果对路由同步的需求不复杂，手动连接的成本极低，仅需监听路由实例的变化，将当前路由信息同步到Redux切片，同时封装可触发路由跳转的action即可，代码完全可控，不存在第三方依赖的兼容隐患。

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