npm ERR! ERESOLVE unable to resolve dependency tree的解决方法

执行 npm install 安装命令时报错：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR!
npm ERR! While resolving: main@undefined
npm ERR! Found: [email protected]
npm ERR! node_modules/react
npm ERR!   react@"17.x" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer react@"16" from @umijs/[email protected]
npm ERR! node_modules/@umijs/plugin-qiankun
npm ERR!   dev @umijs/plugin-qiankun@"^2.27.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! See /root/.npm/eresolve-report.txt for a full report.

解决方法

方法一：在命令中增加 --legacy-peer-dep ：

npm install --legacy-peer-deps

方法二：直接修改 npm 配置：

npm config set legacy-peer-deps true

什么是 peerDependency

在 package.json 文件中，存在一个叫做 peerDependencies（对等依赖关系）的对象，它包含了项目里需要的所有的包或用户正在下载的版本号相同的所有的包。

意思就是对等依赖关系指定我们的包与某个特定版本的 npm 包兼容。

对等依赖关系最好的例子就是 React ，一个声明式的创建用户界面的 JS 库。

假设我们现在有一个 HelloWorld 工程，已经在其根目录下的 package.json 文件中的 dependencies 字段里声明了 packageA 作为依赖，而其下面有两个项目 app_A 和 app_B，它们也依赖 packageA。如果我们用 dependencies 而不是 peerDepenedencies 来声明，那么 npm install 安装完项目之后的依赖结构如下：

├── HelloWorld
│   └── node_modules
│       ├── packageA
│       ├── app_A
│       │   └── nodule_modules
│       │       └── packageA
│       └── app_B
│       │   └── nodule_modules
│       │       └── packageA

packageA 依赖包被安装了 3 次，造成了 2 次安装冗余。

而如果采用 peerDepenedency 来下载，就可以避免这个核心依赖库被重复下载的问题。还是上面那个场景，我们在项目 app_A 和 app_B 的 package.json 文件里的 peerDependencies 字段声明一下核心依赖库 packageA，然后在根目录的 package.json 文件里的 dependencies 字段也声明一下 packageA。接着再执行 npm install，生成的依赖结构就会如下所示：

├── HelloWorld
│   └── node_modules
│       ├── packageA
│       ├── app_A
│       └── app_B

packageA 就只会被安装一次。

因此，npm 从版本 v7 开始，install 就默认以 peerDependencies 的方式去下载了：

如果用户在根目录的 package.json 文件里显式依赖了核心库，那么各个子项目里的 peerDepenedencies 声明就可以忽略。

如果用户没有显式依赖核心库，那么就按照子项目的 peerDepenedencies 中声明的版本将依赖安装到项目根目录里。

而方式 2 就会导致一个问题：用户依赖的包版本与各个子项目依赖的包版本相互不兼容，那么就会报错（无法解析依赖树的问题（依赖冲突））让用户自行去修复，因而导致安装过程的中断。（因为是从 npm v7 引入的，因此 npm v3-v6 就不会发生这个错误）。

总结

npm install xxxx --legacy-peer-deps 命令与其说是告诉 npm 要去干什么，不如说是告诉 npm 不要去干什么。

legacy 的意思：遗产/（软件或硬件）已过时但因使用范围广而难以替代的；

而 npm install xxxx --legacy-peer-deps 命令用于绕过 peerDependency 里依赖的自动安装；

它告诉 npm 忽略项目中引入的各个依赖模块之间依赖相同但版本不同的问题，以 npm v3-v6 的方式去继续执行安装操作。

所以其实该命令并没有真的解决冲突，而是忽略了冲突，以“过时”（v3-v6）的方式进行下载操作。

未经允许不得转载：前端资源网 - w3h5 » npm ERR! ERESOLVE unable to resolve dependency tree的解决方法