Android项目启动构建失败：Unsupported desugared library版本问题求助

错误详情 #

核心错误提示 #

FAILURE: Build failed with an exception.

* 问题原因：
构建操作失败。
无法解析配置 ':app:detachedConfiguration3' 的所有文件。
转换 FakeDependency.jar 以匹配属性 {artifactType=_internal-d8-desugar-methods, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime} 失败。
D8BackportedMethodsGenerator 执行失败: C:\Users\josef\.android\android\FakeDependency.jar。
不支持的脱糖库配置版本，请升级D8/R8编译器。

完整异常栈（简化） #

com.intellij.openapi.externalSystem.model.ExternalSystemException: 构建操作失败。
    无法解析配置 ':app:detachedConfiguration3' 的所有文件。
    转换 FakeDependency.jar 失败，原因：不支持的脱糖库配置版本，请升级D8/R8编译器。
    ...（省略后续调用栈）

解决步骤 #

1. 升级Android Gradle插件（AGP） #

D8/R8编译器是AGP的核心组件，升级AGP即可同步更新编译器版本。修改项目根目录的build.gradle（或build.gradle.kts）：

Groovy 语法

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // 替换为最新稳定版，例如8.2.0+
        classpath 'com.android.tools.build:gradle:8.2.0'
    }
}

Kotlin DSL 语法

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:8.2.0")
    }
}

2. 同步升级Gradle版本 #

AGP与Gradle有严格的版本兼容要求，升级AGP后需修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip

（AGP 8.2.0对应Gradle 8.2，确保版本匹配）

3. 更新脱糖库依赖（若启用库脱糖） #

如果项目开启了核心库脱糖，确保脱糖依赖版本与AGP兼容：
在模块的build.gradle中调整：

android {
    compileOptions {
        coreLibraryDesugaringEnabled true
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
}

4. 清理缓存并重构 #

• 执行清理命令：gradlew clean（Windows）或 ./gradlew clean（Mac/Linux）
• 重启Android Studio，点击「Sync Project with Gradle Files」
• 重新构建项目

备选方案：降级第三方依赖 #

若无法升级AGP/Gradle，可尝试替换FakeDependency.jar为更低版本的包，避免高版本脱糖配置与旧编译器冲突。

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