Flutter升级至3.22.2后遇Firebase重复类依赖错误求助

问题场景 #

将Flutter项目从3.16.9升级到3.22.2，同时在pubspec.yaml中升级了Firebase相关依赖：

cloud_firestore: ^5.0.1
firebase_storage: ^12.0.1
firebase_auth: ^5.1.0
firebase_core: ^3.1.0
firebase_messaging: ^15.0.1

执行flutter pub get无异常，但运行项目时触发以下错误：

* What went wrong:
Execution failed for task ':app:checkDebugDuplicateClasses'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.CheckDuplicatesRunnable
   > Duplicate class com.google.firebase.iid.FirebaseInstanceIdReceiver found in modules jetified-firebase-iid-20.3.0-runtime (com.google.firebase:firebase-iid:20.3.0) and jetified-firebase-messaging-24.0.0-runtime (com.google.firebase:firebase-messaging:24.0.0)

解决方案 #

1. 排除冲突依赖
   打开Android项目的app/build.gradle文件，在dependencies块中给firebase-messaging添加排除规则，移除重复的firebase-iid模块：

   dependencies {
       // 保留其他已有依赖
       implementation platform('com.google.firebase:firebase-bom:32.8.0')
       implementation 'com.google.firebase:firebase-messaging' {
           exclude group: 'com.google.firebase', module: 'firebase-iid'
       }
   }
   

   注：Firebase BOM版本请根据当前插件版本匹配，确保版本兼容性。

2. 清理项目缓存
   执行以下命令彻底清理Flutter和Gradle缓存，避免旧依赖残留：

   flutter clean
   flutter pub get
   cd android && ./gradlew clean
   cd ..
   

3. 验证依赖一致性
   确保所有Firebase插件使用统一的版本规范，优先通过Firebase BOM管理版本，避免不同插件引入不一致的底层Firebase SDK版本。

问题原因 #

firebase-messaging 24.0.0及以上版本已内置firebase-iid的核心功能，但项目中某个依赖（可能是其他Firebase插件或第三方库）仍引入了独立的firebase-iid 20.3.0模块，导致类定义重复触发编译错误。

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