Firebase项目修改firebase-core至12.0.1同步失败，如何解决？

云上老周

2026-5-28

解决Firebase Core 12.0.1依赖解析失败的问题

我之前也踩过一模一样的坑，别慌，咱们一步步排查解决：

确认项目级build.gradle配置了Google Maven仓库
Firebase的依赖只能从Google官方的Maven仓库拉取，所以一定要检查项目根目录下的build.gradle文件，确保repositories块里包含Google仓库。现在一般用google()这个快捷配置，旧版Gradle可以写完整地址：
```
buildscript {
    repositories {
        google() // 替代写法：maven { url "https://maven.google.com" }
        jcenter()
    }
    // 其他配置...
}

allprojects {
    repositories {
        google() // 这里必须也要加！很多人容易漏这一步
        jcenter()
    }
}
```
保证所有Firebase/Play Services依赖版本统一
不能只单独升级firebase-core，所有以com.google.firebase和com.google.android.gms开头的依赖，版本号必须完全一致。比如如果你还用到了firebase-auth或者play-services-location，它们的版本也得是12.0.1，版本不匹配会直接导致依赖解析失败。
验证版本有效性并刷新缓存
12.0.1是Firebase的合法版本，但有时候可能因为本地Gradle缓存过期或者网络问题导致索引没同步。你可以试试点击Gradle窗口的「Refresh all Gradle projects」按钮，或者手动删除本地Gradle缓存（路径一般是~/.gradle/caches）后再重新同步。
检查Android Gradle插件版本兼容性
12.x系列的Firebase依赖要求Android Gradle插件版本至少是3.0.0，同时Google Services插件也要对应适配的版本（比如4.0.1及以上）。可以在项目级build.gradle里查看：
```
dependencies {
    classpath 'com.android.tools.build:gradle:3.0.0' // 建议用更高的稳定版，比如3.2.1
    classpath 'com.google.gms:google-services:4.0.1' // 这个插件版本要和Firebase版本匹配
}
```