Android Studio构建安卓应用报错，依赖/Gradle问题排查求助

问题背景 #

• 团队无安卓开发经验，通过教程学习开发，此前进展顺利
• 添加Kotlin组件后出现大量构建错误，无法理解报错内容
• 推测是依赖或Gradle配置问题，不确定Java主体项目与Kotlin组件是否冲突
• 已尝试更新lifecycle、navigation、recyclerview、material版本，添加Maven仓库，未解决问题

Module:app 依赖配置 #

dependencies {

    def lifecycle_version = "2.6.1"
    def nav_version = "2.5.3"
    def recyclerview_version = "1.3.0"
    def material_version = "1.4.0-alpha01"

    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.8.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    implementation 'com.google.firebase:firebase-auth-ktx:21.3.0'
    implementation 'com.google.firebase:firebase-auth:21.3.0'
    implementation 'com.google.firebase:firebase-firestore:24.5.0'
    implementation 'com.firebaseui:firebase-ui-firestore:8.0.2'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

    // ViewModel
    implementation "android.arch.lifecycle:extensions:$lifecycle_version"
    // LiveData
    implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version"

    // Navigation
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"

    // recyclerview
    implementation "androidx.recyclerview:recyclerview:$recyclerview_version"

    // material
    implementation "com.google.android.material:material:$material_version"


    //OTP PIN
}

Project 级 build.gradle 配置 #

buildscript {
    ext.kotlin_version = "1.4.31"
    repositories{
        google()
        jcenter()
        maven {
            url "https://maven.google.com"
        }
    }
    dependencies {
        def nav_version = "2.5.3"
        classpath 'com.google.gms:google-services:4.3.15'
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.5.3"
        classpath "com.android.tools.build:gradle:4.1.3"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}// Top-level build file where you can add configuration options common to all sub-projects/modules.
plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.android.library' version '7.4.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.8.0' apply false
}

排查解决思路 #

1. 清理重复与冲突依赖 #

• Material依赖重复：同时引入1.8.0和1.4.0-alpha01版本，删除implementation "com.google.android.material:material:$material_version"，保留稳定版1.8.0
• Firebase Auth重复：firebase-auth-ktx已包含核心功能，删除implementation 'com.google.firebase:firebase-auth:21.3.0'
• 旧版Lifecycle依赖冲突：android.arch.lifecycle:extensions是Support库旧依赖，和AndroidX不兼容，替换为AndroidX版本：

  implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
  implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version"
  

2. 统一Kotlin与Gradle插件版本 #

• Project级配置中，buildscript里的kotlin_version（1.4.31）和plugins块的kotlin-android版本（1.8.0）差异过大，统一为1.8.0：
  修改buildscript中的ext.kotlin_version = "1.8.0"，确保kotlin-gradle-plugin使用该版本
• AGP 7.4.2与Kotlin 1.8.0兼容，统一后同步项目

3. 修复Firebase版本兼容性 #

• FirebaseUI与Firebase版本必须严格匹配，firebase-ui-firestore:8.0.2对应Firebase BOM 29.0.0，改用BOM统一版本避免冲突：

  implementation platform('com.google.firebase:firebase-bom:29.0.0')
  implementation 'com.google.firebase:firebase-auth-ktx'
  implementation 'com.google.firebase:firebase-firestore'
  implementation 'com.firebaseui:firebase-ui-firestore:8.0.2'
  

4. 清理缓存并重新构建 #

• 执行File -> Invalidate Caches...，选择Invalidate and Restart
• 手动删除项目根目录.gradle文件夹和app模块build文件夹，重新同步项目

5. 检查Kotlin组件基础配置 #

• 确保app模块build.gradle顶部应用Kotlin插件：

  plugins {
      id 'com.android.application'
      id 'org.jetbrains.kotlin.android'
      id 'com.google.gms.google-services'
  }
  

• 检查Kotlin文件语法是否存在基础错误

6. 定位根错误 #

• 构建失败时，展开Build窗口的完整报错日志，找到最顶部的红色根错误信息（后续错误多为连锁反应），根错误才是问题核心

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