如何添加Map Struct处理器且不移除其他处理器路径？

核心方案：利用Maven的annotationProcessor依赖范围替代显式配置annotationProcessorPaths #

当你显式配置maven-compiler-plugin的annotationProcessorPaths时，Maven会停止自动扫描classpath中的注解处理器，导致原有处理器（如Lombok）失效。要避免手动逐个添加处理器，推荐以下配置方式：

1. 依赖配置
   在pom.xml中声明MapStruct核心依赖、MapStruct处理器、Lombok及绑定工具，其中处理器类依赖使用annotationProcessor范围：

   <dependencies>
       <!-- MapStruct核心API -->
       <dependency>
           <groupId>org.mapstruct</groupId>
           <artifactId>mapstruct</artifactId>
           <version>1.6.0</version>
       </dependency>
       <!-- MapStruct注解处理器 -->
       <dependency>
           <groupId>org.mapstruct</groupId>
           <artifactId>mapstruct-processor</artifactId>
           <version>1.6.0</version>
           <scope>annotationProcessor</scope>
       </dependency>
       <!-- Lombok核心依赖 -->
       <dependency>
           <groupId>org.projectlombok</groupId>
           <artifactId>lombok</artifactId>
           <version>1.18.30</version>
           <scope>provided</scope>
       </dependency>
       <!-- Lombok与MapStruct的绑定工具，避免代码生成冲突 -->
       <dependency>
           <groupId>org.projectlombok</groupId>
           <artifactId>lombok-mapstruct-binding</artifactId>
           <version>0.2.0</version>
           <scope>annotationProcessor</scope>
       </dependency>
   </dependencies>
   

2. Maven编译器插件配置
   仅指定Java版本，无需手动配置annotationProcessorPaths，Maven会自动收集所有annotationProcessor范围的依赖作为注解处理器，同时保留其他依赖中隐含的处理器：

   <build>
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-compiler-plugin</artifactId>
               <version>3.12.1</version>
               <configuration>
                   <source>23</source>
                   <target>23</target>
                   <!-- 可选：添加MapStruct的编译参数，比如启用生成日志 -->
                   <compilerArgs>
                       <arg>-Amapstruct.verbose=true</arg>
                   </compilerArgs>
               </configuration>
           </plugin>
       </plugins>
   </build>
   

为什么这个方案有效 #

• annotationProcessor范围会告诉Maven将该依赖仅用于注解处理阶段，自动加入处理器路径，无需手动维护annotationProcessorPaths列表。
• 不配置annotationProcessorPaths时，Maven会默认扫描classpath中所有包含注解处理器的依赖，避免遗漏HikariCP或其他库的隐含处理器。
• lombok-mapstruct-binding用于协调Lombok和MapStruct的代码生成顺序，防止两者生成的代码冲突。

若必须显式配置annotationProcessorPaths的场景 #

如果你有特殊需求必须显式声明处理器路径，可以直接列出必要的处理器依赖，避免遗漏关键组件：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.12.1</version>
    <configuration>
        <source>23</source>
        <target>23</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct-processor</artifactId>
                <version>1.6.0</version>
            </path>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.30</version>
            </path>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok-mapstruct-binding</artifactId>
                <version>0.2.0</version>
            </path>
            <!-- 添加项目中其他必需的注解处理器依赖 -->
        </annotationProcessorPaths>
    </configuration>
</plugin>

内容的提问来源于stack exchange，提问作者Ali İhsan TAŞDELEN