升级Android Gradle插件至8.2.1后出现coreLibraryDesugaring依赖错误

架构老林

2026-7-2

解决coreLibraryDesugaring配置报错问题

问题根源

你把coreLibraryDesugaring依赖和compileOptions配置放在了项目根目录的build.gradle中，但这些配置必须在具体模块（比如app模块）的build.gradle里声明。根目录build.gradle负责管理项目级插件和全局依赖，模块级build.gradle才是配置单个模块编译规则和依赖的正确位置。

修复步骤

打开模块级build.gradle文件（通常路径是app/build.gradle或app/build.gradle.kts）
在模块的android块内配置编译选项：

android {
    compileOptions {
        isCoreLibraryDesugaringEnabled = true
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
}

在模块的dependencies块内添加desugaring依赖：

dependencies {
    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.0.4")
    // 其他模块依赖（如implementation、api等）继续保留在此处
}

根目录build.gradle仅保留插件声明即可，无需添加编译选项和该依赖：

plugins {
    id("com.android.application") version "8.2.1" apply false
    id("com.google.dagger.hilt.android") version "2.48" apply false
    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
    id("com.google.devtools.ksp") version "1.9.22-1.0.16" apply false
}