Angular14项目安装@angular/fire报依赖冲突、模块找不到问题求助

核心问题本质是@angular/fire稳定版的版本适配、Angular CLI 14的ng add逻辑bug、npm 8严格peer依赖校验三个因素共同导致的，按以下步骤操作即可解决：

1. 清理错误安装残留 #

先把之前安装失败产生的无效文件、缓存全部清掉，避免影响后续安装：

• 卸载错误安装的包：
  npm uninstall @angular/fire firebase
• 强制清理npm安装缓存：
  npm cache clean --force
• 打开项目根目录下的package.json文件，检查dependencies字段，手动删除残留的"@angular/fire": "0.0.0"这类错误版本条目。

2. 安装适配Angular 14的正确版本 #

不要使用ng add @angular/fire命令安装，Angular CLI 14版本下该命令的版本解析逻辑存在bug，会错误拉取0.0.0的占位包，且该占位包不包含schematics支持，直接手动指定兼容版本安装即可：
执行安装命令，指定兼容Angular 14的@angular/fire 7.4.1版本，同时加参数绕过npm 8的严格peer依赖校验，解决ERESOLVE依赖树解析错误：
npm install @angular/fire@7.4.1 firebase@9.9.0 --legacy-peer-deps

版本说明：@angular/fire 从7.4.0版本开始正式支持Angular 14，低于该版本的peer依赖范围仅覆盖Angular 12/13，和当前Angular 14环境不兼容，这也是最开始执行npm安装报ERESOLVE错误的根本原因。

3. 模块引入与报错修复 #

安装完成后按如下方式引入模块即可解决找不到模块的报错：

• 先检查项目node_modules/@angular/fire目录是否存在，package.json中记录的@angular/fire版本是否为7.4.1，确认安装成功。
• 在app.module.ts中按正确路径导入模块，参考代码如下：

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
// 兼容模式导入，API和旧版本保持一致，适配成本低
import { AngularFireModule } from '@angular/fire/compat';
import { AngularFireAuthModule } from '@angular/fire/compat/auth';
import { environment } from '../environments/environment';
import { AppComponent } from './app.component';

@NgModule({
  declarations: [AppComponent],
  imports: [
    BrowserModule,
    // 替换为你自己Firebase项目的配置参数
    AngularFireModule.initializeApp(environment.firebase),
    AngularFireAuthModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

• 如果写完导入代码后IDE仍然提示Cannot find module '@angular/fire'，直接重启IDE的TypeScript服务或者重启IDE即可，这是TS服务的缓存问题，不是安装失败。

额外排查点 #

• 如果执行安装命令始终拉取到0.0.0版本，检查当前使用的npm源，切回npm官方公共源后重新执行安装即可。
• 安装完成后启动项目如果出现peer依赖相关警告，不影响功能正常运行，是部分子依赖的版本声明未及时更新导致的，不需要额外处理。

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