安装react-push-notification报npm ERR! ERESOLVE依赖树冲突如何解决？

冲突本质 #

当前项目依赖的React版本为^17.0.2，而默认安装的react-push-notification@1.3.0仅声明兼容^16.8.0版本的React，npm v7及以上版本会严格校验对等依赖匹配性，因此触发报错。

以下方案按稳妥性从高到低排序：

方案1：安装该包的兼容版本（优先选择） #

先执行如下命令查看该包所有版本的对等依赖要求，确认是否有支持React17的更新版本：

npm view react-push-notification peerDependencies

如果存在兼容React17的版本，直接指定版本号安装即可，示例：

npm i react-push-notification@[兼容版本号]

方案2：替换为同功能兼容包 #

如果react-push-notification没有适配React17的更新，可换用其他维护活跃的同功能依赖，例如react-toastify、react-notifications-component等，这类包普遍兼容React16/17/18全版本，后续维护风险更低。

方案3：临时跳过对等依赖校验（仅短期测试用） #

如果必须使用当前版本的react-push-notification，可添加参数跳过校验，React17对React16的API向下兼容度很高，多数场景下组件可正常运行：

• 单次安装跳过：执行命令

npm i react-push-notification --legacy-peer-deps

• 全局配置跳过（不推荐）：如果频繁遇到同类对等依赖校验问题，可执行npm config set legacy-peer-deps true全局开启该规则，但会弱化依赖校验能力，提高后续冲突概率。

方案4：降级项目React版本（最不推荐） #

仅当以上方案全部不可行时，再考虑将项目React版本降级到^16.8.0：

npm i react@16.14.0 react-dom@16.14.0

降级前需提前评估项目现有其他依赖是否兼容React16，避免触发更多依赖冲突。

注意事项 #

如果使用--legacy-peer-deps参数安装，安装完成后需对通知功能做全量测试，确认不存在渲染异常、回调失效等API不兼容问题。

内容的提问来源于stack exchange，提问作者Qatr El-Nada