Android Studio原生Java项目Google Play Services及Firebase依赖报错如何解决

该报错由两个核心原因导致：一是Gradle未配置正确的依赖拉取仓库，无法找到对应的Google官方组件；二是引入的Google Play Services、Firebase、OneSignal依赖版本互不兼容，出现版本冲突。可按以下步骤逐一排查解决：

步骤1：修正依赖仓库配置 #

• 若使用7.0以下版本的Android Gradle Plugin（AGP），修改项目根目录的build.gradle文件，确保allprojects > repositories下优先配置google()仓库：

allprojects {
    repositories {
        // 优先从Google官方仓库拉取组件，必须放在其他公有仓库前
        google()
        mavenCentral()
        // 项目原有其他仓库可正常保留
    }
}

• 若使用7.0及以上版本的AGP，修改项目根目录的settings.gradle文件，确保dependencyResolutionManagement > repositories下优先配置google()仓库：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 优先从Google官方仓库拉取组件，必须放在其他公有仓库前
        google()
        mavenCentral()
        // 项目原有其他仓库可正常保留
    }
}

步骤2：删除废弃的全局Play Services依赖 #

当前引入的全局com.google.android.gms:play-services:12.0.1属于早已废弃的依赖写法，会强制所有Play Services组件锁定在停止维护的12.0.1版本，和更高版本的Firebase组件产生强制冲突。请删除该全局依赖，仅按需引入实际用到的Play Services单独子包（如需要推送功能仅引入play-services-messaging即可）。

步骤3：使用BOM统一对齐组件版本 #

在app模块的build.gradle依赖中引入Google官方提供的BOM组件，无需再单独指定各个Firebase、Play Services子包的版本号，BOM会自动匹配所有组件的兼容版本，从根源避免版本冲突：

dependencies {
    // 导入Firebase、Play Services统一版本BOM，版本号可根据需要替换为最新稳定版
    implementation platform('com.google.firebase:firebase-bom:32.8.1')
    implementation platform('com.google.android.gms:play-services-bom:18.2.0')
    
    // 以下依赖无需写版本号，自动匹配BOM对应的兼容版本
    implementation 'com.google.firebase:firebase-analytics'
    implementation 'com.google.firebase:firebase-messaging'
    // 其他你用到的Firebase、Play Services组件都按此格式添加
    
    // 升级OneSignal到适配高版本Play Services的稳定版，避免兼容问题
    implementation 'com.onesignal:OneSignal:4.8.6'
}

步骤4：清理缓存重新构建 #

1. 点击Android Studio菜单栏 File > Invalidate Caches...，勾选清理文件系统缓存和本地历史选项，点击重启IDE
2. 重启后在项目终端执行./gradlew clean命令清理旧构建缓存，再点击Gradle同步按钮重新拉取所有依赖

补充说明 #

若调整后仍无法拉取依赖，检查你的网络环境是否能正常访问Google服务，可更换网络或配置国内可用的Maven镜像源。

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