Maven同一类多位置扫描警告问题求助（fop与fop-core冲突）

收到的Maven警告信息： #

[WARNING] org.apache.fop.accessibility.StructureTreeEventHandler scanned from multiple locations: 
jar:file:///C:/Users/westjjes/.m2/MY_APP/org/apache/xmlgraphics/fop/2.6/fop-2.6.jar!/org/apache/fop/accessibility/StructureTreeEventHandler.class, 

jar:file:///C:/Users/westjjes/.m2/MY_APP/org/apache/xmlgraphics/fop-core/2.6/fop-core-2.6.jar!/org/apache/fop/accessibility/StructureTreeEventHandler.class

问题原因 #

Apache FOP从2.x版本开始做了模块拆分：将核心功能抽离为fop-core包，而fop包本身变成了聚合型jar（内置fop-core及其他扩展模块的完整内容）。当项目同时依赖fop和fop-core时，就会触发重复类警告——因为fop.jar已经包含了fop-core的所有类文件。

解决方法 #

由于无法排除fop-core（项目编译依赖其核心类），正确处理方式如下：

• 移除对fop-2.6.jar的直接/间接依赖，仅保留fop-core-2.6.jar作为核心依赖。
• 如果项目需要FOP的扩展功能（如特定格式支持、额外工具类），不要直接依赖fop包，而是按需添加对应的FOP扩展模块（例如fop-pdf-images、fop-events等）。

具体操作步骤： #

1. 执行Maven命令排查fop依赖的引入来源：

   mvn dependency:tree -Dverbose -Dincludes=org.apache.xmlgraphics:fop
   

2. 在引入fop的间接依赖中添加排除规则：

   <dependency>
       <groupId>[间接依赖的groupId]</groupId>
       <artifactId>[间接依赖的artifactId]</artifactId>
       <version>[版本号]</version>
       <exclusions>
           <exclusion>
               <groupId>org.apache.xmlgraphics</groupId>
               <artifactId>fop</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

3. 确保项目pom中直接声明fop-core依赖：

   <dependency>
       <groupId>org.apache.xmlgraphics</groupId>
       <artifactId>fop-core</artifactId>
       <version>2.6</version>
   </dependency>
   

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