自定义依赖引入Lombok及注解处理器引发Maven编译问题求助

我在做微服务通信Demo时，为了简化多服务的依赖管理，把Lombok、MapStruct这类公共依赖和它们的注解处理器都整合到了common模块里。程序运行完全正常，但执行mvn clean compile时，依赖common模块的服务会报错，提示找不到common包里的枚举类。后来我在每个依赖common的服务中单独添加了Lombok、MapStruct及其处理器，问题才解决，但搞不懂为啥注解处理器会引发这个问题，特来请教。

相关POM代码 #

common模块的POM文件 #

<dependencies>
<!--    其他无问题的依赖    -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </dependency>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${mapstruct.version}</version>
    </dependency>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>${mapstruct.version}</version>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </path>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <excludes>
                    <exclude>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

依赖common的服务POM片段 #

<dependency>
    <groupId>com.order.management</groupId>
    <artifactId>common</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

问题根源解析 #

1. 注解处理器配置不传递
   Maven的annotationProcessorPaths是当前模块的编译专属配置，不会随着依赖传递给下游模块。你在common模块里配置了Lombok和MapStruct的处理器路径，但依赖它的服务编译时，根本看不到这个配置，导致编译阶段缺少必要的注解处理器。

2. 枚举找不到是间接结果
   如果common里的枚举用了Lombok注解（比如@Getter），或者有MapStruct映射类依赖这个枚举，那么服务编译时，因为缺少处理器，无法正确解析common模块的源码/字节码，编译器就会误以为枚举不存在。

3. 运行时正常的原因
   运行时类路径里已经有common模块编译好的字节码（里面的枚举已经被Lombok处理过），所以程序能正常跑，但mvn clean compile是从头构建，依赖模块的编译产物还没生成或无法被正确解析，就会报错。

正确的整合方案 #

方案1：父POM全局配置注解处理器 #

在项目的父POM中通过pluginManagement统一配置maven-compiler-plugin的注解处理器路径，所有子模块自动继承：

<build>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <annotationProcessorPaths>
                        <path>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                            <version>${lombok.version}</version>
                        </path>
                        <path>
                            <groupId>org.mapstruct</groupId>
                            <artifactId>mapstruct-processor</artifactId>
                            <version>${mapstruct.version}</version>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
        </plugins>
    </pluginManagement>
</build>

之后每个服务模块只需要引入common依赖，不需要重复配置处理器。

方案2：拆分注解处理器模块 #

单独创建一个common-annotation-processors模块，专门管理所有注解处理器依赖，然后在需要编译的服务模块中，通过annotationProcessorPaths引入这个模块：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <annotationProcessorPaths>
            <path>
                <groupId>com.order.management</groupId>
                <artifactId>common-annotation-processors</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

注意事项 #

• common模块只保留Lombok、MapStruct的API依赖（比如mapstruct），不要放processor依赖，避免不必要的传递。
• 不要在common模块的annotationProcessorPaths里配置处理器，因为这个配置对下游模块无效。

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