升级Gradle插件3.1.0与Android Studio3.1.1后编译失败求助

刚升级完Gradle插件和AS就遭遇compileDebugJavaWithJavac任务失败的坑？我之前也碰到过类似情况，下面几个实战方案大概率能帮你搞定：

1. 确保Java版本适配 #

Gradle插件3.1.x要求使用Java 8及以上版本，很多编译失败的根源就在这里：

• 先检查AS的JDK配置：打开File > Project Structure > SDK Location，确认JDK路径指向的是Java 8（比如jdk1.8.xxx）。
• 同时在app模块的build.gradle中添加Java 8编译配置：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

2. 清理缓存并强制刷新依赖 #

缓存冲突是升级版本后常见的问题，彻底清理后再构建：

• 图形化操作：点击AS顶部菜单栏File > Invalidate Caches / Restart，选择Invalidate and Restart，等待AS重启后重新构建项目。
• 命令行操作（更彻底）：在项目根目录执行：

  # macOS/Linux
  ./gradlew clean build --refresh-dependencies
  # Windows
  gradlew clean build --refresh-dependencies
  

3. 排查第三方依赖兼容性 #

旧版本的第三方库（尤其是注解处理器、字节码修改类库，比如早期的ButterKnife、Dagger）可能和Gradle 3.1.x不兼容：

• 把项目中的第三方依赖逐一更新到官方最新稳定版，优先检查那些涉及编译、注解处理的库。
• 如果不确定哪个库有问题，可以尝试临时注释部分依赖，逐步排查出冲突的库。

4. 调整Lint检查策略 #

Gradle 3.1.x对Lint的检查严格度提升了，一些潜在的Lint问题会直接导致编译终止：

• 可以先临时关闭Lint的错误终止开关，验证是否是Lint导致的问题：

android {
    lintOptions {
        abortOnError false
    }
}

• 如果编译成功了，再根据AS的Lint提示逐个修复问题，之后再把abortOnError改回true。

5. 排查自定义编译逻辑冲突 #

如果你项目中用到了自定义Gradle Task、或者非官方的编译插件，这些可能和新版本Gradle不兼容：

• 检查项目根目录和app模块的build.gradle，移除或更新那些不再维护的自定义插件/task。
• 确保所有插件的版本和Gradle插件3.1.0适配（比如Android插件3.1.0对应Gradle 4.4及以上版本）。

如果以上方案都没解决问题，建议把compileDebugJavaWithJavac任务的完整错误日志贴出来（你目前只提供了错误栈的开头部分），比如具体是哪个类编译失败、或者注解处理器抛出了什么异常，这样能更精准定位问题。

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