Angular 8升级至9时出现对等依赖冲突，求排查原因

问题描述 #

我按照Angular升级指南执行升级操作，运行命令：

cmd /C "set "NG_DISABLE_VERSION_CHECK=1" && npx @angular/cli@8 update @angular/cli@8 @angular/core@8" -C

但触发了以下npm依赖解析错误：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: genxml@0.0.0
npm ERR! Found: @angular-devkit/build-angular@0.803.29
npm ERR! node_modules/@angular-devkit/build-angular
npm ERR!   dev @angular-devkit/build-angular@"^0.901.15" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! dev @angular-devkit/build-angular@"^0.901.15" from the root project
npm ERR!
npm ERR! Conflicting peer dependency: @angular/compiler-cli@9.1.13
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   peer @angular/compiler-cli@">=9.0.0 < 10" from @angular-devkit/build-angular@0.901.15
npm ERR!   node_modules/@angular-devkit/build-angular
npm ERR!     dev @angular-devkit/build-angular@"^0.901.15" from the root project

我清楚@angular-devkit/build-angular@0.901.15要求@angular/compiler-cli版本在9.0.0至10之间，且我的package.json中@angular/compiler-cli版本为"~9.1.13"，想知道问题出在哪里？

问题根源 #

你当前的目标是升级到Angular 8，但项目的package.json中保留了Angular 9版本的@angular-devkit/build-angular依赖（^0.901.15对应Angular 9版本的构建工具），两者的依赖需求完全冲突：

• 你执行的命令会尝试安装Angular 8配套的@angular-devkit/build-angular（0.8.x系列版本）
• 但package.json里明确指定了要使用9.x版本的构建工具，它要求compiler-cli必须是9.x版本，而你要降级到Angular 8，自然触发npm的依赖解析冲突。

解决步骤 #

1. 修正构建工具版本：手动修改package.json，将@angular-devkit/build-angular的版本改为Angular 8对应的范围，比如^0.803.29（和错误日志中已存在的版本匹配），或者直接写~0.8.0
2. 清理npm缓存：运行以下命令避免缓存干扰依赖解析：

   npm cache clean --force
   

3. 重新执行升级：可以先卸载当前的构建工具再执行升级命令：

   npm uninstall @angular-devkit/build-angular --save-dev
   cmd /C "set "NG_DISABLE_VERSION_CHECK=1" && npx @angular/cli@8 update @angular/cli@8 @angular/core@8" -C
   

4. 检查版本一致性：升级完成后，确认package.json中所有Angular相关依赖（core、cli、compiler-cli等）的版本统一为8.x，避免混合不同大版本的包。

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