Kotlin Android项目添加依赖后出现Firebase未解析引用及依赖异常求助

1. 核对Firebase依赖的正确写法 #

在app/build.gradle里，必须用Kotlin适配的ktx版本依赖，比如要加Auth就这么写：

dependencies {
    implementation("com.google.firebase:firebase-auth-ktx:22.3.1")
    // 其他组件比如Firestore，按需添加对应的ktx依赖
    implementation("com.google.firebase:firebase-firestore-ktx:24.10.0")
}

别用Java版本的依赖，不然Kotlin里会找不到firebase引用。

2. 确认项目级仓库配置 #

不管是Gradle 7.0+的settings.gradle还是旧版的项目级build.gradle，必须加上google()仓库——Firebase依赖只能从这里下载：

• Gradle 7.0+（settings.gradle）：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

• 旧版Gradle（项目根目录build.gradle）：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.google.gms:google-services:4.4.1") // 尽量用最新稳定版
    }
}
allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

3. 摆正Google Services插件的位置 #

com.google.gms.google-services插件必须放在app/build.gradle的插件列表最后，顺序错了会直接导致依赖解析失败：

plugins {
    id("com.android.application")
    id("kotlin-android")
    id("kotlin-kapt")
    id("com.google.gms.google-services") // 就放最后，别乱改顺序
}

4. 清缓存重构建 #

先执行Gradle命令清缓存、刷新依赖：

./gradlew clean
./gradlew build --refresh-dependencies

或者在Android Studio里点File -> Invalidate Caches... -> Invalidate and Restart，彻底清缓存重启，很多时候这步就能解决问题。

5. 检查google-services.json文件 #

确保从Firebase控制台下载的google-services.json已经放到app/目录下，没有这个文件，Google Services插件没法正确配置Firebase，自然会出问题。

6. 核对版本兼容性 #

Firebase组件版本和Google Services插件版本要匹配，别随便乱搭版本，尽量用官网推荐的最新稳定版，避免版本冲突导致解析失败。

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