新建Android Studio项目为何出现classpath解析错误？

问题描述 #

使用「Bottom Navigation Activity」模板从零创建新项目，Android Studio构建时立即报错：

无法解析配置':classpath'的所有文件。
无法解析com.android.tools.build:gradle:7.4.2。
所需依赖：
project : > com.android.application:com.android.application.gradle.plugin:7.4.2
project : > com.android.library:com.android.library.gradle.plugin:7.4.2
未找到匹配的com.android.tools.build:gradle:7.4.2变体。消费者配置为寻找兼容Java 8、以jar包形式打包、依赖外部声明的运行时库，且要求属性'org.gradle.plugin.api-version'值为'7.5'，但：

• 变体'apiElements'声明的com.android.tools.build:gradle:7.4.2为jar包形式的库，依赖外部声明：
  • 不兼容：该组件声明兼容Java 11的API，而消费者需要兼容Java 8的运行时组件
  • 其他兼容属性：未提及org.gradle.plugin.api-version（要求为'7.5'）
• 变体'javadocElements'声明的com.android.tools.build:gradle:7.4.2为运行时组件，依赖外部声明：
  • 不兼容：该组件为文档类型，而消费者需要库
  • 其他兼容属性：未提及目标Java版本（要求兼容Java 8）、未提及打包形式（要求jar包）、未提及org.gradle.plugin.api-version（要求为'7.5'）
• 变体'runtimeElements'声明的com.android.tools.build:gradle:7.4.2为jar包形式的运行时库，依赖外部声明：
  • 不兼容：该组件声明兼容Java 11，而消费者需要兼容Java 8的组件
  • 其他兼容属性：未提及org.gradle.plugin.api-version（要求为'7.5'）
• 变体'sourcesElements'声明的com.android.tools.build:gradle:7.4.2为运行时组件，依赖外部声明：
  • 不兼容：该组件为文档类型，而消费者需要库
  • 其他兼容属性：未提及目标Java版本（要求兼容Java 8）、未提及打包形式（要求jar包）、未提及org.gradle.plugin.api-version（要求为'7.5'）

疑问：

1. 使用官方模板未修改代码为何报错？
2. 旧应用因谷歌政策更新引发大量编译错误，半年前正常现在全报错，如何解决？
3. 是否有更稳定的IDE可选？

原因分析 #

1. 核心矛盾是Gradle插件（AGP）版本与Java版本、Gradle版本不匹配：AGP 7.4.2要求使用Java 11，但项目默认配置了Java 8，同时AGP 7.4.2对应的Gradle版本需为7.5+，两者版本不兼容导致解析失败。
2. 官方模板报错是因为Android Studio版本与模板默认AGP版本不同步，或是本地环境的Java版本未跟上AGP的要求。
3. 旧项目报错是因为谷歌政策要求升级API级别，同时旧项目的AGP、Gradle、Java版本已无法适配新的依赖库和编译环境。

解决步骤 #

1. 升级项目Java版本到11 #

• 打开模块级build.gradle（或build.gradle.kts），修改编译配置：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_11
          targetCompatibility JavaVersion.VERSION_11
      }
      // 若使用Kotlin，添加以下配置
      kotlinOptions {
          jvmTarget = "11"
      }
  }
  

• 在项目根目录gradle.properties中指定Java 11路径（或通过IDE设置：File > Project Structure > SDK Location > JDK Location选择Java 11）：

  org.gradle.java.home=/path/to/your/jdk11
  

2. 匹配AGP与Gradle版本 #

• 修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本为AGP 7.4.2兼容的7.5版本：

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

3. 清理IDE缓存 #

• 点击File > Invalidate Caches...，勾选Invalidate and Restart，重启IDE后重新构建项目。

4. 旧项目适配方案 #

• 逐步升级AGP版本至与当前IDE兼容的稳定版，同时同步升级Gradle和Java版本；
• 检查并更新所有第三方依赖库至最新兼容版本；
• 按照谷歌政策要求升级目标API级别（如targetSdkVersion 33+）。

稳定IDE选择 #

• Android Studio稳定版：优先选择官方发布的稳定版本（如Giraffe 2022.3.1、Hedgehog 2023.1.1），这些版本经过充分测试，兼容性较好。若当前版本问题多，可降级至半年前使用的稳定版本，确保AGP、Gradle、Java版本三者匹配。
• IntelliJ IDEA Ultimate：与Android Studio同核心，对Android开发支持完全一致，稳定性有保障，但需付费（提供免费试用）。

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