执行npm install失败：Angular项目依赖版本冲突求助

问题描述 #

执行npm install安装依赖时触发ERESOLVE错误，核心冲突点：当前项目依赖@angular/core@12.0.3，但@amcharts/amcharts3-angular@3.0.2要求的peer依赖@angular/core版本范围为^12.2.0 || ^13.0.0 || ^14.0.0，版本不兼容导致依赖解析失败。

错误日志详情：

D:\Startup\AmBlock\AmBlockApp>npm i      
npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: @amcharts/amcharts3-angular@3.0.2
npm ERR! Found: @angular/core@12.0.3
npm ERR! node_modules/@angular/core
npm ERR!   @angular/core@"~12.0.3" from the root project
npm ERR!   peer @angular/core@"12.0.3" from @angular/animations@12.0.3
npm ERR!   node_modules/@angular/animations
npm ERR!     @angular/animations@"~12.0.3" from the root project
npm ERR!     peer @angular/animations@"^12.0.0 || ^13.0.0-0" from @angular/material@12.0.3
npm ERR!     node_modules/@angular/material
npm ERR!       @angular/material@"^12.0.3" from the root project
npm ERR!     2 more (@angular/platform-browser, @swimlane/ngx-charts)
npm ERR!   13 more (@angular/cdk, @angular/common, @angular/flex-layout, ...)
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/core@"^12.2.0 || ^13.0.0 || ^14.0.0" from @amcharts/amcharts3-angular@3.0.2
npm ERR! node_modules/@amcharts/amcharts3-angular
npm ERR!   @amcharts/amcharts3-angular@"^3.0.2" from the root project
npm ERR!
npm ERR! Conflicting peer dependency: @angular/core@14.2.12
npm ERR! node_modules/@angular/core
npm ERR!   peer @angular/core@"^12.2.0 || ^13.0.0 || ^14.0.0" from @amcharts/amcharts3-angular@3.0.2
npm ERR!   node_modules/@amcharts/amcharts3-angular
npm ERR!     @amcharts/amcharts3-angular@"^3.0.2" 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 C:\Users\hp\AppData\Local\npm-cache\eresolve-report.txt for a full report.

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\hp\AppData\Local\npm-cache\_logs\2023-02-04T07_43_43_807Z-debug-0.log

解决方案 #

方案1：降级@amcharts/amcharts3-angular到兼容版本 #

查找@amcharts/amcharts3-angular版本历史，选择支持@angular/core@12.0.3的版本（如2.x系列），执行以下命令：

# 卸载现有版本
npm uninstall @amcharts/amcharts3-angular
# 安装兼容版本（示例为2.2.0，可根据实际情况调整）
npm install @amcharts/amcharts3-angular@^2.2.0

也可直接修改项目根目录package.json中@amcharts/amcharts3-angular的版本号为兼容值，再执行npm install。

方案2：升级Angular核心包到符合要求的版本 #

将@angular/core升级到12.2.x版本（与现有12.x系列最接近，最小化其他依赖冲突）：

ng update @angular/core@12 @angular/cli@12

若需升级到13或14版本，执行对应版本的升级命令，同时同步升级其他Angular相关依赖（如@angular/material、@angular/animations等），避免新冲突。

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

使用npm兼容模式强制安装，忽略peer依赖版本不匹配，但可能引发运行时未知问题：

# 推荐使用更温和的legacy-peer-deps模式
npm install --legacy-peer-deps
# 或使用force强制覆盖，风险更高
npm install --force

内容的提问来源于stack exchange，提问作者Solih N