React项目NPM Peer Dependencies依赖冲突问题求助

错误信息（中文翻译） #

npm ERR! 代码 ERESOLVE
npm ERR! ERESOLVE 无法解析依赖树
npm ERR!
npm ERR! 解析时: eh-frontend@0.1.0
npm ERR! 已找到: react@17.0.2
npm ERR! node_modules/react
npm ERR!   react@"^17.0.2" 来自根项目
npm ERR!   peer react@">=16.8.6" 来自 @chakra-ui/icons@1.1.7
npm ERR!   node_modules/@chakra-ui/icons
npm ERR!     @chakra-ui/icons@"^1.1.7" 来自根项目
npm ERR!   另外2个依赖 (@emotion/react, @emotion/styled)
npm ERR!
npm ERR! 无法解析依赖:
npm ERR! peer react@">=18" 来自 @chakra-ui/system@2.3.1
npm ERR! node_modules/@chakra-ui/system
npm ERR!   peer @chakra-ui/system@">=1.0.0" 来自 @chakra-ui/icons@1.1.7
npm ERR!   node_modules/@chakra-ui/icons
npm ERR!     @chakra-ui/icons@"^1.1.7" 来自根项目
npm ERR!
npm ERR! 修复上游依赖冲突，或使用 --force 或 --legacy-peer-deps 参数重试命令
npm ERR! 以接受不正确（可能损坏）的依赖解析结果。
npm ERR!
npm ERR! 完整报告请查看: C:\Users\Admin\AppData\Local\npm-cache\eresolve-report.txt

npm ERR! 本次运行的完整日志可在以下位置找到:
npm ERR!     C:\Users\Admin\AppData\Local\npm-cache\_logs\2022-11-08T16_29_29_291Z-debug-0.log

问题原因 #

当前项目使用的React版本为17.0.2，但依赖的@chakra-ui/system@2.3.1要求React版本必须≥18；而项目中安装的@chakra-ui/icons@1.1.7又依赖@chakra-ui/system≥1.0.0，导致npm无法构建合法的依赖树，抛出ERESOLVE错误。

解决方案 #

方案1：升级React到18.x版本

彻底匹配@chakra-ui/system@2.x的版本要求：

• 执行命令升级React及ReactDOM：

npm install react@^18.0.0 react-dom@^18.0.0

• 升级后需检查项目代码，适配React18的API变更（如将ReactDOM.render替换为createRoot），同时确认其他依赖是否兼容React18。

方案2：降级Chakra UI依赖到兼容React17的版本

Chakra UI v1系列完全兼容React17，可将相关依赖降级：

• 执行命令安装兼容版本：

npm install @chakra-ui/icons@^1.1.7 @chakra-ui/system@^1.12.1

• 或手动修改package.json中Chakra UI相关依赖版本为^1.x，再执行npm install。

方案3：临时跳过peer依赖检查（不推荐长期使用）

若暂时无法调整版本，可使用npm兼容参数强制安装：

npm install --legacy-peer-deps

注意：该方法会忽略peer依赖冲突，可能引发潜在兼容性问题，仅建议作为临时方案。

内容的提问来源于stack exchange，提问作者M.G.S SUPUNTHAKA