Android Java 版本与 Gradle 版本兼容问题：use incompatible Java 21.0.3 and Gradle 4.8.1.

问题与处理策略

问题描述

• 打开一个 Android 项目，报如下错误

  Your build is currently configured to use incompatible Java 21.0.3 and Gradle 4.8.1. Cannot sync the project.
  We recommend upgrading to Gradle version 8.9.
  The minimum compatible Gradle version is 8.5.
  The maximum compatible Gradle JVM version is 10.
  Possible solutions:
   - Upgrade to Gradle 8.9 and re-sync
   - Upgrade to Gradle 8.5 and re-sync
  

  # 翻译
  您的版本当前配置为，使用不兼容的 Java 21.0.3 和 Gradle 4.8.1，无法同步项目
  我们建议升级到 Gradle 8.9 版本
  最低兼容 Gradle 版本为 8.5
  Gradle JVM 的最大兼容版本为 10
  可能的解决方案：
  - 升级到 Gradle 8.9 并重新同步
  - 升级到 Gradle 8.5 并重新同步
  

  问题原因

  • 当前项目的 Java 21.0.3 和 Gradle 4.8.1 不兼容，导致 Gradle 正确构建项目

    1. Gradle 版本过低，这里给出建议升级到 Gradle 8.9 版本

    2. Java 版本过高，这里给出最大兼容版本为 10

    处理策略

    （1）升级 Gradle

    • 在 gradle-wrapper.properties 文件中，修改 distributionUrl 属性，将其修改为指向 Gradle 8.9 的分发版

      distributionBase=GRADLE_USER_HOME
      distributionPath=wrapper/dists
      distributionUrl=https\://services.gradle.org/distributions/gradle-4.8.1-all.zip
      zipStoreBase=GRADLE_USER_HOME
      zipStorePath=wrapper/dists
      

      # 修改为
      distributionBase=GRADLE_USER_HOME
      distributionPath=wrapper/dists
      distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip
      zipStoreBase=GRADLE_USER_HOME
      zipStorePath=wrapper/dists
      

      （2）降级 Java

      • 在 Android Studio 中，检查 Gradle Java 的配置

        1. 打开 【File】 -> 【Settings】

        2. 导航到 【Build, Execution, Deployment】 -> 【Build Tools】 -> 【Gradle】

        
        • 修改 Gradle Java 的配置，将 Java 21 改为 Java 8