Android Studio Ladybug与AGP 8.7.2兼容性及Java 21适配问题咨询

算力阿峰

2026-6-16

问题解答

1. AGP 8.7.x 与 Java 21 的兼容性

根据官方兼容性矩阵，AGP 8.7.x 确实不支持 Java 21——它的最高兼容版本是 Java 17。这就是你遇到工具链匹配错误的核心原因：AGP 8.7.2 要求使用 Java 17 编译，但你当前的 Studio 捆绑了 Java 21，本地没有符合要求的工具链，且未配置自动下载的仓库。

2. 为何 AGP 升级助手会建议升级到 8.7.2？

Android Studio Ladybug 本身支持 Java 21，但它的 AGP 升级助手逻辑是优先推荐当前 Studio 版本支持的稳定版 AGP，没有严格校验当前项目使用的 JDK 版本与目标 AGP 的兼容性。简单来说，助手只看 Studio 能不能运行这个 AGP，没考虑你的项目 JDK 和 AGP 的匹配关系。

3. 是否有用户在 Ladybug 中搭配 Java 21 使用 AGP 8.7.2？

有部分用户尝试过，但大多都遇到了和你一样的工具链错误。要解决这个问题，有两种可行方案：

方案一：切换到 Java 17 工具链
在项目的项目级 build.gradle 或 gradle.properties 中指定 Java 17 作为编译工具链：
```
// 项目级 build.gradle
java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}
```
或者在 gradle.properties 添加：
```
org.gradle.java.home=/path/to/java17
```
如果本地没有 Java 17，可在 Android Studio 中通过 File > Project Structure > SDK Location > JDK Location 选择下载 Java 17。
方案二：升级到支持 Java 21 的 AGP 版本
AGP 8.8.0 及以上版本正式支持 Java 21。你可以忽略助手的 8.7.2 建议，手动修改项目级 build.gradle 中的 AGP 版本到 8.8.0+，比如：
```
dependencies {
    classpath 'com.android.tools.build:gradle:8.8.0'
}
```