Gradle从6.6.1升级至7.2后与IDEA冲突导致构建失败如何解决

1. 优先排查全局环境兼容性 #

• 打开系统原生终端（不要用IDEA内置终端）依次执行以下命令，确认基础环境配置：

  # 查看Java版本，Gradle 7.2 支持Java 8~17，超出该范围会直接报错
  java -version
  # 查看JAVA_HOME路径，确认指向的JDK版本和上面输出的版本一致
  echo $JAVA_HOME
  # Windows系统执行 echo %JAVA_HOME%
  # 查看Gradle版本，确认输出为7.2且无报错
  gradle -version
  

• 如果系统原生终端执行gradle -version依然报错：
  • 检查Gradle安装包完整性，可重新下载Gradle 7.2官方包解压后重新配置环境变量
  • 确认JDK版本符合要求，若使用JDK 18及以上版本需降级到支持的版本范围
• 如果系统原生终端执行正常，说明问题出在IDEA的环境覆盖，继续往下排查

2. 校验IDEA Gradle配置 #

• 打开IDEA设置页：构建、执行、部署 > 构建工具 > Gradle
• 确认以下配置项：
  • Gradle用户主目录：和系统全局的Gradle家目录保持一致
  • 使用的Gradle：如果选「wrapper」，需打开项目下gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl指向的是Gradle 7.2的正确资源地址；如果选「指定位置」，确认路径指向你本地安装的Gradle 7.2目录
  • Gradle JVM：选择和$JAVA_HOME版本完全一致的JDK，不要用IDEA自带的JRE

3. 项目适配性排查 #

Gradle 6到7属于大版本迭代，存在大量破坏性变更，很多旧配置会直接失效：

• 执行以下命令输出完整报错日志，定位具体问题点：

  gradle build --stacktrace
  

• 常见适配点检查：
  • 旧的compile、testCompile等依赖配置已被彻底移除，需替换为implementation、api、testImplementation
  • 检查项目使用的第三方Gradle插件版本，很多低版本插件不支持Gradle 7.x，需升级到对应适配版本
  • 检查settings.gradle、根目录及子模块的build.gradle中是否使用了Gradle 7已移除的废弃API

4. 全链路缓存清理 #

• 删除项目根目录下的.gradle、.idea文件夹
• 删除全局Gradle缓存，默认路径为用户目录下的.gradle/caches文件夹
• 点击IDEA菜单栏文件 > 无效缓存并重启，勾选「清除文件系统缓存和本地历史」后确认重启

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