执行npm install firebase安装Firebase时遇ERESOLVE依赖冲突求助

执行npm install firebase安装Firebase时触发ERESOLVE错误，核心冲突是项目中已有的react-currency-format@1.1.0仅支持React ^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0版本，但当前项目使用的是react@18.2.0，两者的peer依赖不兼容。重复执行npm i firebase也无法解决，完整错误日志如下：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: react-currency-format@1.1.0
npm ERR! Found: react@18.2.0
npm ERR! node_modules/react
npm ERR!   peer react@">=16.8.0" from @emotion/react@11.11.1
npm ERR!   node_modules/@emotion/react
npm ERR!     peer @emotion/react@"^11.0.0-rc.0" from @emotion/styled@11.11.0
npm ERR!     node_modules/@emotion/styled
npm ERR!       peerOptional @emotion/styled@"^11.3.0" from @mui/material@5.14.16
npm ERR!       node_modules/@mui/material
npm ERR!         peer @mui/material@"^5.0.0" from @mui/icons-material@5.14.16
npm ERR!         node_modules/@mui/icons-material
npm ERR!         1 more (the root project)
npm ERR!       3 more (@mui/styled-engine, @mui/system, the root project)
npm ERR!     peerOptional @emotion/react@"^11.5.0" from @mui/material@5.14.16
npm ERR!     node_modules/@mui/material
npm ERR!       peer @mui/material@"^5.0.0" from @mui/icons-material@5.14.16
npm ERR!       node_modules/@mui/icons-material
npm ERR!         @mui/icons-material@"^5.14.16" from the root project
npm ERR!       1 more (the root project)
npm ERR!     3 more (@mui/styled-engine, @mui/system, the root project)
npm ERR!   peer react@">=16.8.0" from @emotion/styled@11.11.0
npm ERR!   node_modules/@emotion/styled
npm ERR!     peerOptional @emotion/styled@"^11.3.0" from @mui/material@5.14.16
npm ERR!     node_modules/@mui/material
npm ERR!       peer @mui/material@"^5.0.0" from @mui/icons-material@5.14.16
npm ERR!       node_modules/@mui/icons-material
npm ERR!         @mui/icons-material@"^5.14.16" from the root project
npm ERR!       1 more (the root project)
npm ERR!     peerOptional @emotion/styled@"^11.3.0" from @mui/styled-engine@5.14.16
npm ERR!     node_modules/@mui/styled-engine
npm ERR!       @mui/styled-engine@"^5.14.16" from @mui/system@5.14.16
npm ERR!       node_modules/@mui/system
npm ERR!         @mui/system@"^5.14.16" from @mui/material@5.14.16
npm ERR!         node_modules/@mui/material
npm ERR!     2 more (@mui/system, the root project)
npm ERR!   16 more (@emotion/use-insertion-effect-with-fallbacks, ...)
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0" from react-currency-format@1.1.0
npm ERR! node_modules/react-currency-format
npm ERR!   react-currency-format@"^1.1.0" from the root project
npm ERR!
npm ERR! Conflicting peer dependency: react@17.0.2
npm ERR! node_modules/react
npm ERR!   peer react@"^0.14 || ^15.0.0-rc || ^15.0.0 || ^16.0.0-rc || ^16.0.0 || ^17.0.0" from react-currency-format@1.1.0
npm ERR!   node_modules/react-currency-format
npm ERR!     react-currency-format@"^1.1.0" from the root project
npm ERR!
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR!
npm ERR!
npm ERR! For a full report see:
npm ERR! C:\Users\DELL\AppData\Local\npm-cache\_logs\2023-11-08T20_50_52_755Z-eresolve-report.txt

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\DELL\AppData\Local\npm-cache\_logs\2023-11-08T20_50_52_755Z-debug-0.log

解决方法 #

• 优先升级react-currency-format到兼容React 18的版本
  先查看该包的最新版本：

  npm show react-currency-format versions
  

  安装最新兼容版本（通常最新版已支持React 18）：

  npm install react-currency-format@latest
  

  之后再正常安装Firebase：

  npm install firebase
  

• 临时绕过依赖校验（不推荐长期使用）
  直接在安装Firebase时添加参数，跳过peer依赖冲突检查：

  npm install firebase --legacy-peer-deps
  

  或者强制安装：

  npm install firebase --force
  

  注意：--force可能引入不稳定的依赖组合，--legacy-peer-deps会采用npm旧版本的依赖处理逻辑，避免严格校验。

• 降级React到17版本（迫不得已时使用）
  如果无法升级react-currency-format，可临时降级React版本：

  npm install react@17.0.2 react-dom@17.0.2
  

  之后再安装Firebase：

  npm install firebase
  

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