Angular 15升级至16遇依赖冲突及编译包缺失问题求助

一、解决Peer依赖冲突问题 #

报错核心是@angular/cdk@16.1.2要求@angular/common@16.0.0+，但项目中ng2-pdfjs-viewer@15.0.0和ng9-password-strength-bar@1.1.0的peer依赖限制了@angular/common的版本范围，导致版本冲突。

处理步骤：

• 更新第三方兼容包：
  1. 查找ng2-pdfjs-viewer的Angular 16适配版本（如16.x.x系列），修改package.json中该包的版本号后重新安装。
  2. ng9-password-strength-bar命名带有ng9，大概率已停止维护，建议替换为支持Angular 16的密码强度组件；若必须保留，可尝试临时使用npm install --force跳过冲突，但存在运行风险。
• 统一Angular核心包版本：
  确保所有@angular/*开头的依赖（core、common、cli、cdk等）版本统一为16.1.2，手动修改package.json示例：

  {
    "@angular/common": "^16.1.2",
    "@angular/core": "^16.1.2",
    "@angular/cdk": "^16.1.2",
    "@angular/cli": "^16.1.2"
  }
  

二、解决@angular/compiler-cli缺失问题 #

使用--legacy-peer-deps后出现找不到该包的错误，是因为npm未正确安装对应版本的编译工具，或版本不匹配。

处理步骤：

• 手动安装对应版本的compiler-cli：
  执行命令：

  npm install @angular/compiler-cli@16.1.2 --save-dev
  

• 清理缓存后重新安装：
  1. 删除本地依赖文件：
     Windows系统：

     rd /s /q node_modules
     del package-lock.json
     

     macOS/Linux系统：

     rm -rf node_modules package-lock.json
     

  2. 清理npm缓存并重新安装：

     npm cache clean --force
     npm install
     

三、额外优化建议 #

• 优先使用Angular官方升级命令，它会自动处理大部分依赖适配：

  ng update @angular/core@16 @angular/cli@16
  

• 对于未适配Angular 16的第三方包，优先查看其官方仓库确认是否有更新计划，无计划则及时替换为维护活跃的替代组件。

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