Ionic Cordova构建Firebase应用报错：多库包名冲突求助

安全阿岳

2026-5-20

解决Firebase集成后Gradle构建因重复com.google.android.gms.license包失败的问题

我之前也碰到过一模一样的情况！昨天构建还完全正常，集成Firebase后突然就报这个多包名冲突的错误，折腾了好一会儿才搞定，给你几个亲测有效的解决办法：

统一Google服务相关依赖的版本
这是最常见的原因——不同版本的Firebase或Google Play Services库会引入重复的license模块。你可以在项目根目录的build.gradle里用变量统一管理版本，确保所有相关依赖用同一个版本号：
```
ext {
    googleServicesVersion = "4.4.0"
    firebaseVersion = "21.5.0" // 换成当前官方稳定版
}
```
然后在模块的build.gradle里引用这些变量，比如：
```
implementation "com.google.firebase:firebase-auth:$firebaseVersion"
implementation "com.google.android.gms:play-services-location:$googleServicesVersion"
```
手动排除重复的license依赖
先通过./gradlew app:dependencies命令生成依赖树，定位到哪个库重复引入了com.google.android.gms.license，然后在依赖声明里排除它：
```
implementation('com.google.firebase:firebase-analytics:$firebaseVersion') {
    exclude group: 'com.google.android.gms', module: 'license'
}
```
注意别盲目排除，一定要先找到重复的来源再操作。
更新Google Services插件版本
旧版本的Google Services插件可能会在依赖解析时出问题，去项目根目录的build.gradle里把插件版本更到最新稳定版：
```
dependencies {
    classpath 'com.google.gms:google-services:4.4.0' // 检查并更新到最新版
}
```
清理Gradle缓存后重新构建
有时候缓存会保留旧的依赖信息，执行下面的命令清理后再尝试构建：
```
./gradlew clean
./gradlew build --refresh-dependencies
```