Android Studio更新后出现Gradle CompilationFailedException编译异常

我之前更新Android Studio后也碰到过一模一样的问题，这个CompilationFailedException其实只是个“概括性提示”——它只告诉你编译失败了，但没说具体原因，关键是要找到编译器输出的详细错误信息，接下来我分享几个我当时排查和解决的步骤：

第一步：先找到具体的错误细节 #

你可以这么操作：

• 打开Android Studio底部的Build窗口，点击窗口右上角的「Toggle View」按钮（就是那个带箭头的展开图标），展开完整的编译日志；
• 或者切换到Gradle Console标签页，这里会输出Gradle编译的所有细节，往下翻就能找到真正导致失败的具体错误（比如代码语法问题、依赖冲突、JDK版本不匹配等）。

常见的解决场景（根据具体错误对应处理） #

1. JDK版本不兼容 #

更新AS后，默认的JDK路径可能变了（比如切换到了AS自带的嵌入式JDK），或者项目的编译配置和当前JDK版本不匹配：

• 先去File > Project Structure > SDK Location里确认JDK的路径和版本；
• 然后在app模块的build.gradle里，确保compileOptions和JDK版本一致，比如用Java 8的话：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_1_8
          targetCompatibility JavaVersion.VERSION_1_8
      }
      // 如果是Kotlin项目，还要加上Kotlin的JVM目标配置
      kotlinOptions {
          jvmTarget = "1.8"
      }
  }
  

2. 缓存导致的问题 #

更新AS后，旧的编译缓存很可能和新环境不兼容，先试试清理重建：

• 点击顶部菜单栏的Build > Clean Project，等待清理完成；
• 再点击Build > Rebuild Project，重新编译整个项目。

3. Gradle插件与依赖版本冲突 #

AS更新后，Gradle插件版本可能自动升级了，但项目里的依赖库版本没跟上，导致不兼容：

• 打开项目根目录的build.gradle，检查classpath 'com.android.tools.build:gradle:x.x.x'的版本，确保它和项目使用的Gradle版本匹配（比如插件7.4.2对应Gradle 7.5，AS会在你升级插件时提示你同步Gradle版本）；
• 如果日志里提示某个依赖找不到或者冲突，比如旧的support库和androidx冲突，那就要把所有support依赖换成androidx的，同时在gradle.properties里添加：

  android.useAndroidX=true
  android.enableJetifier=true
  

4. 编译器语法检查变严格 #

新版本的AS可能启用了更严格的语法检查，之前能通过的代码现在报错了（比如空安全、Lambda表达式写法等），这时候根据日志里的行号，找到对应的代码修改就行。

5. 临时禁用增量编译（应急方案） #

如果以上都没解决，可能是增量编译的问题，可以在gradle.properties里添加一行：

android.enableIncrementalCompile=false

不过这只是临时解决，最好还是找到根本原因。

总之，这个异常本身没什么信息量，一定要先找到具体的错误日志，再针对性解决。

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