Angular环境下安装@angular/fire时出现依赖冲突错误

问题概述 #

执行ng add @angular/fire@latest安装Angular Fire时触发依赖树解析错误，核心冲突为：项目中@angular/common@16.0.2与@angular/fire@7.5.0要求的@angular/common@^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0版本不兼容，尝试指定不同Firebase版本也无法解决。

环境信息 #

Angular CLI: 16.0.2
Node: 18.16.0
Package Manager: npm 9.5.1
OS: linux x64

项目包版本 #

Package                         Version
---------------------------------------------------------
@angular-devkit/architect       0.1600.2
@angular-devkit/build-angular   16.0.2
@angular-devkit/core            16.0.2
@angular-devkit/schematics      16.0.2
@angular/cli                    16.0.2
@angular/fire                   0.0.0
@schematics/angular             16.0.2
rxjs                            7.8.1
typescript                      5.0.4

解决方案 #

1. 安装适配Angular 16的Angular Fire版本 #

Angular Fire从v7.6.0开始正式支持Angular 16，直接安装该版本或更高版本即可解决冲突：

# 安装第一个支持Angular 16的版本
ng add @angular/fire@7.6.0

# 或者安装最新兼容版本（若当前latest已支持Angular 16）
ng add @angular/fire@latest

2. 手动修复（若上述命令仍报错） #

如果自动安装命令有问题，可手动卸载后重新安装：

# 移除不兼容的依赖（若已安装）
npm uninstall @angular/fire firebase

# 安装兼容版本组合
npm install @angular/fire@^7.6.0 firebase@^9.22.0

3. 验证安装 #

安装完成后，检查package.json中的依赖项，确保@angular/fire版本≥7.6.0，且执行npm ls无版本冲突提示。

原因说明 #

@angular/fire@7.5.0的版本约束仅覆盖Angular 12~15，而你的项目使用Angular 16，版本完全超出支持范围，导致npm无法完成依赖树解析。升级到支持Angular 16的Angular Fire版本是唯一解决途径。

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