Android Studio Ladybug迁移项目后Java与Gradle版本不兼容问题

报错信息 #

Your build is currently configured to use incompatible Java 21.0.3 and Gradle 8.4. Cannot sync the project.

系统读取到的Java路径为/Applications/Android Studio.app/Contents/jbr/Contents/Home下的Java 21.0.3。

已尝试操作 #

• 进入File -> New Project Setup -> Project Default Structure -> Gradle，将默认Gradle JDK修改为/Users/ashwin/.sdkman/candidates/java/11.0.25-ms（该路径包含Java 11的bin/java，且被识别为有效JDK）。
• 设置环境变量STUDIO_JDK为/Users/ashwin/.sdkman/candidates/java/11.0.25-ms。

以上操作均未生效，仍出现版本不兼容错误。

补充信息 #

项目根目录build.gradle内容：

buildscript {
    ext {
        compose_ui_version = '1.6.4'
        room_version = "2.6.1"
    }
}// Top-level build file where you can add configuration options common to all sub-projects/modules.
plugins {
    id 'com.android.application' version '8.3.2' apply false
    id 'com.android.library' version '8.3.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.0' apply false
    id("androidx.room") version "$room_version" apply false

}

项目结构截图：

问题原因及解决方法 #

1. 检查当前项目的Gradle JDK配置 #

你修改的是全局默认Gradle JDK，但当前项目可能有独立配置覆盖了全局设置：

• 打开File -> Project Structure -> Project（注意是当前项目的结构，而非全局默认设置）
• 在Gradle JDK下拉菜单中选择/Users/ashwin/.sdkman/candidates/java/11.0.25-ms，点击Apply和OK后重新同步项目。

2. 直接在gradle.properties中强制指定JDK #

在项目根目录的gradle.properties文件中添加以下配置，优先级高于IDE设置：

org.gradle.java.home=/Users/ashwin/.sdkman/candidates/java/11.0.25-ms

添加完成后点击同步按钮，让Gradle加载新配置。

3. 升级Gradle版本适配Java 21 #

Gradle 8.4不支持Java 21，若想保留Java 21，需升级Gradle到8.5及以上版本：

• 修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip
  

• 同步升级Android Gradle Plugin（AGP）版本到兼容Gradle 8.5的版本，比如将根build.gradle中的AGP版本从8.3.2改为8.4.0，同时建议将Kotlin版本升级到1.9.0以上：

  plugins {
      id 'com.android.application' version '8.4.0' apply false
      id 'com.android.library' version '8.4.0' apply false
      id 'org.jetbrains.kotlin.android' version '1.9.20' apply false
      id("androidx.room") version "$room_version" apply false
  }
  

4. 验证环境变量生效 #

设置STUDIO_JDK后需重启Android Studio才能生效，可先在终端执行echo $STUDIO_JDK确认路径正确，再重启IDE同步项目。

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