如何修复Java Spring Boot模块循环导致的注解处理错误？

这个错误的核心原因是rooms和students模块形成了循环依赖，而Java注解处理器（比如Lombok、MapStruct这类工具）不支持处理存在循环依赖的模块。下面是几种可行的解决办法：

1. 拆分公共模块彻底解耦（推荐方案） #

把两个模块共享的代码（比如实体类、DTO、公共接口等）抽离到一个独立的common模块中，让rooms和students都依赖这个common模块，而非互相依赖。

• 举个例子：将Room、Student实体类，以及两个模块都需要用到的业务接口移到common，rooms模块专注处理房间相关的业务逻辑，students模块处理学生相关逻辑，两者通过common中的对象进行交互，从根源上打破循环依赖。

2. 临时配置排除循环模块的注解处理 #

如果暂时无法重构架构，可以通过构建工具配置，排除循环模块的注解处理：

Maven 配置 #

在模块的pom.xml中修改maven-compiler-plugin：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <annotationProcessorPaths>
            <!-- 这里放你的注解处理器依赖，比如Lombok -->
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.30</version>
            </path>
        </annotationProcessorPaths>
        <excludes>
            <exclude>**/rooms/**</exclude>
            <exclude>**/students/**</exclude>
        </excludes>
    </configuration>
</plugin>

Gradle 配置 #

在模块的build.gradle中添加：

tasks.withType(JavaCompile) {
    options.annotationProcessorPath = configurations.annotationProcessor
    // 排除循环模块的注解处理
    exclude '**/rooms/**'
    exclude '**/students/**'
}

注意：这种方法只是临时规避手段，长期使用会丢失注解处理器的功能（比如Lombok自动生成getter/setter），不推荐作为最终解决方案。

3. 依赖反转或延迟加载缓解问题 #

• 依赖反转：在其中一个模块定义抽象接口，另一个模块实现该接口。比如在rooms模块定义StudentService接口，students模块实现这个接口，rooms通过Spring依赖注入调用接口，而非直接依赖students的具体类。
• 延迟加载：使用Spring的@Lazy注解标记循环依赖的Bean，延迟其初始化时机，缓解初始化阶段的循环依赖问题，但这也只是治标不治本的方法。

内容的提问来源于stack exchange，提问作者George Jonathan Osafo-Osei