Gradle 4.7执行bootRepackage任务报错，旧版本构建正常

嘿，我来帮你捋捋Gradle从3.4.*升级到4.7后，Spring Boot项目构建失败的问题——这类跨版本升级，往往是兼容性变化搞的鬼，我整理了几个最常见的坑和对应的解决办法：

1. Spring Boot插件版本不兼容 #

Gradle 4.7对插件的兼容性有明确要求，旧版Spring Boot Gradle插件（比如1.5.x早期版本）大概率不支持Gradle 4.x系列，这是最常见的触发原因。

• 解决步骤：
  • 打开项目根目录的build.gradle，找到Spring Boot插件的依赖配置：

    buildscript {
        dependencies {
            classpath 'org.springframework.boot:spring-boot-gradle-plugin:1.5.10.RELEASE' // 旧版本示例
        }
    }
    

  • 升级到兼容Gradle 4.7的插件版本：
    • 如果愿意升级Spring Boot主版本，直接切换到2.0.x及以上的插件（注意Spring Boot 2.x要求JDK 8+），比如：

      buildscript {
          dependencies {
              classpath 'org.springframework.boot:spring-boot-gradle-plugin:2.0.9.RELEASE'
          }
      }
      

    • 如果不想动Spring Boot主版本，Spring Boot 1.5.x系列的1.5.22.RELEASE是最后一个支持Gradle 4.x的版本，可以直接升级到这个版本。

2. Groovy版本冲突 #

Gradle 4.7自带的Groovy版本是2.4.12，要是你的项目依赖了其他版本的Groovy，很容易出现类加载冲突。比如Spring Boot 1.5.x早期版本默认依赖的Groovy版本可能和这个不一致。

• 解决步骤：
  • 在build.gradle中统一Groovy版本，和Gradle自带版本对齐：

    dependencies {
        compile 'org.codehaus.groovy:groovy-all:2.4.12'
    }
    

  • 或者借助Spring Boot的依赖管理BOM来自动统一版本，避免手动维护：

    dependencyManagement {
        imports {
            mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
        }
    }
    

3. 过时的Gradle配置语法 #

Gradle 4.x开始逐步废弃了一些旧语法，虽然compile这类配置在4.7中还能临时用，但部分插件的配置逻辑已经变化，比如Spring Boot插件的一些旧配置项被标记为废弃。

• 解决步骤：
  • 替换过时的依赖配置语法：把compile/testCompile替换为implementation/testImplementation（这是Gradle 3.4之后推荐的写法，Spring Boot插件2.x会自动适配）：

    // 旧写法
    compile 'com.google.guava:guava:20.0'
    // 新写法
    implementation 'com.google.guava:guava:20.0'
    

  • 检查springBoot配置块，比如executable等旧配置项的写法是否需要调整，参考对应Spring Boot插件版本的官方文档修正。

4. 依赖缓存损坏 #

升级Gradle版本后，本地缓存的依赖可能出现版本不匹配或者损坏的情况，导致构建时找不到正确的类或资源。

• 解决步骤：
  • 执行强制刷新依赖的构建命令：

    gradle clean build --refresh-dependencies
    

  • 如果还是不行，手动删除Gradle缓存目录：
    • Linux/Mac：~/.gradle/caches
    • Windows：C:\Users\<你的用户名>\.gradle\caches
      删除后重新执行gradle build。

5. JDK版本不达标 #

Gradle 4.7要求必须使用JDK 8或更高版本，如果你的项目还在使用JDK 7，肯定会触发构建错误。

• 解决步骤：
  • 在build.gradle中明确指定JDK版本：

    sourceCompatibility = 1.8
    targetCompatibility = 1.8
    

  • 检查本地Gradle使用的JDK版本，执行gradle -v查看输出中的JVM信息，确保是JDK 8及以上。

如果上面的办法都没解决，建议你把具体的报错堆栈信息贴出来，这样能更精准定位问题~

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