如何在XMLBeans Maven插件中正确配置并使用自定义扩展？

我完全懂你现在的困扰——XMLBeans插件死活找不到你的自定义扩展类，报ClassNotFoundException对吧？这其实是Maven插件类加载机制的常见“坑”，我来一步步帮你搞定它。

问题根源分析 #

Maven插件运行在独立的类加载器环境中，默认情况下不会自动包含项目中未编译的代码，也不会直接继承项目的类路径。你的MyExtension是项目内的自定义类，而XMLBeans的compile goal执行时，项目的主代码还没被编译，插件自然找不到它；就算代码已经编译，插件的类加载器也不会主动去读取项目的编译目录。

针对性解决方案 #

根据你的场景（扩展类是项目内代码），我给你两种可行的解决思路，推荐优先用第一种，更符合Maven的最佳实践。

方案1：拆分模块（推荐）

把自定义扩展类放到单独的Maven模块中，先编译打包这个模块，再让使用XMLBeans的模块依赖它，同时把这个模块加到XMLBeans插件的依赖里。

步骤拆解：

1. 创建扩展模块：比如my-xmlbeans-extensions，把MyExtension类放到这个模块的src/main/java/com/chepseskaf/tools下，模块的pom.xml要引入XMLBeans依赖：

package com.chepseskaf.tools;
import org.apache.xmlbeans.SchemaTypeSystem;
import org.apache.xmlbeans.impl.tool.SchemaCompilerExtension;
import java.util.Map;

public class MyExtension implements SchemaCompilerExtension {
    @Override
    public void schemaCompilerExtension(SchemaTypeSystem schemaTypeSystem, Map map) {
        // 这里可以添加你的扩展逻辑
    }

    @Override
    public String getExtensionName() {
        return this.getClass().getSimpleName();
    }
}

模块的pom.xml配置：

<project>
  <groupId>com.chepseskaf</groupId>
  <artifactId>my-xmlbeans-extensions</artifactId>
  <version>${project.version}</version>
  <dependencies>
    <dependency>
      <groupId>org.apache.xmlbeans</groupId>
      <artifactId>xmlbeans</artifactId>
      <version>5.3.0</version>
    </dependency>
  </dependencies>
</project>

2. 在主模块中配置XMLBeans插件：主模块依赖扩展模块，同时把扩展模块加到插件的<dependencies>中（这样插件的类加载器就能找到MyExtension）：

<plugin>
  <groupId>org.apache.xmlbeans</groupId>
  <artifactId>xmlbeans</artifactId>
  <version>5.3.0</version>
  <executions>
    <execution>
      <goals>
        <goal>compile</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <repackage>com.chepseskaf.driver.metadata</repackage>
    <name>model</name>
    <partialMethods>ALL</partialMethods>
    <sourceDir>${project.basedir}/xsd</sourceDir>
    <extensions>
      <extension>com.chepseskaf.tools.MyExtension</extension>
    </extensions>
    <verbose>true</verbose>
    <quiet>false</quiet>
  </configuration>
  <dependencies>
    <!-- 加入扩展模块的依赖 -->
    <dependency>
      <groupId>com.chepseskaf</groupId>
      <artifactId>my-xmlbeans-extensions</artifactId>
      <version>${project.version}</version>
    </dependency>
    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-core</artifactId>
      <version>3.0.0-beta3</version>
    </dependency>
  </dependencies>
</plugin>

3. 按顺序构建：先构建扩展模块（mvn clean install -f my-xmlbeans-extensions/pom.xml），再构建主模块，问题就能解决。

方案2：单项目内调整编译顺序（应急用）

如果不想拆分模块，可以通过调整Maven的执行阶段，先编译MyExtension类，再让XMLBeans插件运行，同时把项目的编译目录加到插件的类路径中：

<build>
  <plugins>
    <!-- 1. 先编译主源码（包含MyExtension） -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <executions>
        <execution>
          <id>pre-compile-extension</id>
          <phase>process-resources</phase>
          <goals>
            <goal>compile</goal>
          </goals>
        </execution>
      </executions>
    </plugin>

    <!-- 2. 再执行XMLBeans编译，此时MyExtension已经编译完成 -->
    <plugin>
      <groupId>org.apache.xmlbeans</groupId>
      <artifactId>xmlbeans</artifactId>
      <version>5.3.0</version>
      <executions>
        <execution>
          <id>xmlbeans-generate</id>
          <phase>compile</phase>
          <goals>
            <goal>compile</goal>
          </goals>
        </execution>
      </executions>
      <configuration>
        <repackage>com.chepseskaf.driver.metadata</repackage>
        <name>model</name>
        <partialMethods>ALL</partialMethods>
        <sourceDir>${project.basedir}/xsd</sourceDir>
        <extensions>
          <extension>com.chepseskaf.tools.MyExtension</extension>
        </extensions>
        <verbose>true</verbose>
        <quiet>false</quiet>
      </configuration>
      <dependencies>
        <!-- 把项目编译后的类目录加到插件依赖中 -->
        <dependency>
          <groupId>com.chepseskaf</groupId>
          <artifactId>你的项目artifactId</artifactId>
          <version>${project.version}</version>
          <scope>system</scope>
          <systemPath>${project.build.directory}/classes</systemPath>
        </dependency>
        <dependency>
          <groupId>org.apache.logging.log4j</groupId>
          <artifactId>log4j-core</artifactId>
          <version>3.0.0-beta3</version>
        </dependency>
      </dependencies>
    </plugin>
  </plugins>
</build>

⚠️ 注意：这种方式用了system scope，不符合Maven的依赖管理规范，只适合临时应急，长期维护还是推荐拆分模块。

额外检查点 #

1. 确认你的扩展类实现的接口是对的：你用的org.apache.xmlbeans.impl.tool.SchemaCompilerExtension是XMLBeans扩展的正确接口，没问题。
2. 保持XMLBeans版本一致：插件用了5.3.0，扩展模块的XMLBeans依赖也要用5.3.0，避免版本冲突。
3. 开启DEBUG日志排查：如果还是有问题，用mvn clean install -X运行，查看类加载的详细日志，能快速定位类路径问题。

内容来源于stack exchange