Spring Boot无法找到GroovySystem问题排查及兼容版本咨询

Hey there, let's break down your problem step by step and get your Spring Boot Batch project up and running smoothly!

问题回顾 #

你在启动项目时先碰到了java.lang.NoClassDefFoundError: groovy/lang/GroovySystem，添加groovy-all:2.4.5依赖后又出现了java.lang.IncompatibleClassChangeError: Implementing class，这两个问题都和Groovy依赖的缺失或版本不兼容有关。

问题原因 #

1. 第一个错误（NoClassDefFoundError）：Spring的GroovyBeanDefinitionReader类需要Groovy核心类库的支持，但你的项目里没有引入Groovy依赖，导致JVM找不到groovy.lang.GroovySystem这个类。
2. 第二个错误（IncompatibleClassChangeError）：你添加的Groovy 2.4.5版本太老，和你使用的Spring Boot 2.1.4（对应Spring 5.1.6）不兼容。Groovy 2.4和2.5在类结构上有不少变化，导致Spring的代码无法和旧版本Groovy正常协作。

修复方案 #

1. 替换Groovy依赖，使用兼容版本 #

别再用groovy-all了，它包含大量不必要的子模块，很容易引发依赖冲突。建议直接引入Groovy核心依赖，并且使用和Spring Boot 2.1.4匹配的版本：

方式一：让Spring Boot自动管理版本（推荐）

Spring Boot的parent依赖已经内置了兼容的Groovy版本，直接引入即可，不用手动指定版本：

<dependency>
    <groupId>org.codehaus.groovy</groupId>
    <artifactId>groovy</artifactId>
</dependency>

Spring Boot 2.1.4对应的Groovy版本是2.5.8，这个版本和Spring 5.1.6完全兼容。

方式二：手动指定兼容版本

如果需要手动控制版本，直接指定2.5.x系列的稳定版本：

<dependency>
    <groupId>org.codehaus.groovy</groupId>
    <artifactId>groovy</artifactId>
    <version>2.5.8</version>
</dependency>

2. 清理不必要的插件（按需操作） #

• 如果你的项目里没有Groovy编写的业务代码，只是Spring内部用到Groovy相关类，那完全不需要gmavenplus-plugin，把它从pom.xml里删掉就行，避免额外的编译流程问题。
• 如果确实有Groovy代码需要编译，要确保插件版本和Groovy版本匹配，别用RELEASE版本（可能拉到不兼容的最新版），推荐使用1.8.1版本的插件：

<plugin>
    <groupId>org.codehaus.gmavenplus</groupId>
    <artifactId>gmavenplus-plugin</artifactId>
    <version>1.8.1</version>
    <executions>
        <execution>
            <goals>
                <goal>addSources</goal>
                <goal>addTestSources</goal>
                <goal>generateStubs</goal>
                <goal>compile</goal>
                <goal>testGenerateStubs</goal>
                <goal>testCompile</goal>
                <goal>removeStubs</goal>
                <goal>removeTestStubs</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Spring Beans与Groovy版本兼容说明 #

针对你使用的Spring Beans 5.1.6.RELEASE（来自Spring Boot 2.1.4），官方推荐的兼容Groovy版本是2.5.x系列（2.5.8及以上都可以）。给你整理一下Spring 5.x整体的Groovy兼容范围：

• Spring 5.0.x：兼容Groovy 2.4.x ~ 2.5.x
• Spring 5.1.x：优先推荐Groovy 2.5.x（2.4.x部分版本会出现类结构不兼容问题，就是你碰到的错误）
• Spring 5.2+：兼容Groovy 2.5.x 和 3.0.x

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