Maven pom如何配置插件从target加载类而非jar依赖

多模块Maven项目中，原xxx插件通过插件自身依赖引入yyyy外部Jar包加载所需类，原配置如下：

<plugin>   
  <groupId>xxxx</groupId>
  <artifactId>xxx</artifactId>
  <version>xxx</version>
  <dependencies>
    <dependency>
      <groupId>yyyy</groupId>
      <artifactId>yyyy</artifactId>
      <version>yyy</version>
    </dependency>
    <!-- 其余依赖省略 -->
  </dependencies>
</plugin>

需满足的强制要求：

• 移除yyyy外部依赖，将该依赖的源码迁移至项目src目录，作为项目自有代码维护
• 全流程禁止再引入、使用yyyy的外部依赖包
• xxx插件必须从当前项目project/target编译输出目录加载所需类

当前故障：xxx插件运行时仍检索原yyyy依赖路径下的类，不会从项目target目录加载迁移后的自有代码类。

按以下步骤操作即可满足要求：

1. 清理插件依赖残留
   直接删除xxx插件配置块下<dependencies>标签中所有和yyyy相关的依赖项，从根源上避免插件类加载器优先命中旧的外部Jar包。注意全局排查父POM、子POM中是否在pluginManagement里也配置了该插件的yyyy依赖，全部移除，执行mvn dependency:tree确认插件类路径中无yyyy的Jar残留。

2. 调整插件执行的生命周期绑定节点
   Maven插件默认不会自动加载当前项目的编译输出类，必须保证插件执行时机在主代码编译完成之后。将xxx插件的执行目标绑定到process-classes生命周期阶段，这个阶段主源码已经完成编译，target/classes目录下的Class文件已全部生成，不会出现类文件不存在的问题。配置示例：

   <plugin>   
     <groupId>xxxx</groupId>
     <artifactId>xxx</artifactId>
     <version>xxx</version>
     <!-- 已删除所有yyyy相关依赖 -->
     <executions>
       <execution>
         <id>run-xxx-task</id>
         <phase>process-classes</phase>
         <goals>
           <goal><!-- 替换为插件实际执行的goal名称 --></goal>
         </goals>
       </execution>
     </executions>
   </plugin>
   

3. 显式将项目编译输出目录加入插件类加载路径
   绝大多数Maven插件默认不会把当前项目的输出目录纳入自身类加载搜索范围，需要显式追加：

   • 如果插件本身提供了类路径配置项，直接将${project.build.outputDirectory}（对应target/classes的绝对路径）加到类路径配置的最优先位置，保证类加载时先搜索该目录。
   • 通用兼容方案：绝大多数Maven插件都支持additionalClasspathElements配置参数，直接在插件configuration块中追加该配置即可：

   <configuration>
     <additionalClasspathElements>
       <element>${project.build.outputDirectory}</element>
       <!-- 多模块场景下如果依赖其他子模块的类，追加对应子模块的输出目录即可 -->
     </additionalClasspathElements>
   </configuration>
   

4. 验证加载逻辑
   执行mvn clean process-classes -X，通过debug日志查看插件的类加载搜索路径顺序，确认两点：

   • 类路径中不存在任何yyyy相关的外部Jar包
   • ${project.build.outputDirectory}在类路径的靠前位置，插件加载对应类时命中target目录下的Class文件

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