如何将自定义Annotation Processor与MapStruct结合使用？

核心问题定位 #

当同时引入自定义注解处理器和MapStruct时，MapStruct无法生成实现类，通常是注解处理器配置不完整或依赖冲突导致MapStruct的处理器未被正确触发执行。以下是具体的解决步骤：

1. 修正Maven注解处理器配置 #

必须将MapStruct和自定义处理器同时配置在maven-compiler-plugin的annotationProcessorPaths中，这是确保两者都能被编译期执行的关键。不要直接在dependencies中添加处理器依赖，否则可能导致处理器无法被正确识别。

正确的插件配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 适配你的JDK版本选择合适的插件版本 -->
            <configuration>
                <source>1.8</source> <!-- 替换为你的项目JDK版本 -->
                <target>1.8</target>
                <annotationProcessorPaths>
                    <!-- 自定义FieldProperty注解处理器 -->
                    <path>
                        <groupId>你的自定义处理器GroupId</groupId>
                        <artifactId>field-property-processor</artifactId>
                        <version>处理器对应版本号</version>
                    </path>
                    <!-- MapStruct注解处理器 -->
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.5.Final</version> <!-- 使用你项目中实际的MapStruct版本 -->
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 排查并解决依赖冲突 #

自定义处理器可能引入了与MapStruct重复的依赖（如javax.annotation-api、javax.persistence-api等），导致MapStruct处理器无法正常工作。可以通过排除重复依赖来解决：

<dependency>
    <groupId>你的自定义处理器GroupId</groupId>
    <artifactId>field-property-processor</artifactId>
    <version>处理器对应版本号</version>
    <exclusions>
        <exclusion>
            <groupId>javax.annotation</groupId>
            <artifactId>javax.annotation-api</artifactId>
        </exclusion>
        <!-- 根据实际冲突情况添加其他排除项 -->
    </exclusions>
</dependency>

3. 调整处理器执行顺序（可选） #

部分场景下，自定义处理器的执行优先级可能影响MapStruct的扫描逻辑。尝试将MapStruct的处理器配置放在自定义处理器之前，调整annotationProcessorPaths中的顺序：

<annotationProcessorPaths>
    <!-- 先配置MapStruct处理器 -->
    <path>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.5.Final</version>
    </path>
    <!-- 再配置自定义处理器 -->
    <path>
        <groupId>你的自定义处理器GroupId</groupId>
        <artifactId>field-property-processor</artifactId>
        <version>处理器对应版本号</version>
    </path>
</annotationProcessorPaths>

4. 验证处理器执行状态 #

如果问题仍未解决，可以添加编译参数查看注解处理器的执行流程，确认MapStruct是否被触发：
在maven-compiler-plugin的configuration中添加：

<compilerArgs>
    <arg>-XprintRounds</arg>
</compilerArgs>

执行mvn clean compile，查看控制台输出，确认是否存在MapStructProcessor的执行记录。如果没有，说明MapStruct的处理器未被正确配置。

5. 检查Mapper接口注解 #

确保你的Mapper接口正确标注了MapStruct的@Mapper注解，且componentModel配置符合项目需求（如Spring环境下使用@Mapper(componentModel = "spring")），同时确认自定义注解未干扰MapStruct对接口的扫描逻辑。

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