Maven插件Jar包加载失败求助：自定义类加载器无法加载目标类

你的代码存在几个关键问题导致类加载失败：

1. Classpath获取逻辑错误
   mavenProject.getCompileClasspathElements().get(0) 取的是项目自身的target/classes目录，父目录target下的jar是当前项目打包的产物，而你要加载的com.x.y.z.MyClass属于其他团队的依赖，这类jar存放在本地Maven仓库，不在当前项目的target目录下，所以你只加载了当前项目的jar，自然找不到目标类。

2. 仅加载单个jar，忽略依赖链
   目标类可能依赖其他jar包，只加载单个jar会导致类依赖缺失，即使找到目标jar也可能加载失败。

3. 类加载器父加载器选择不当
   使用mavenProject.getClass().getClassLoader()作为父加载器，可能会因为Maven核心类加载器的委托机制，无法正确加载业务依赖类。

修改后的代码示例 #

@Mojo(name = "report", threadSafe = true, defaultPhase = LifecyclePhase.PACKAGE)
@Execute(phase = LifecyclePhase.PACKAGE)
public class JavadocMojo extends AbstractMojo {

    @Component
    private MavenProject mavenProject;

    @Override
    public void execute() {
        try {
            // 获取完整的编译+运行时classpath，包含项目classes和所有依赖jar
            List<String> classpathElements = mavenProject.getCompileClasspathElements();
            URL[] classpathUrls = new URL[classpathElements.size()];
            
            for (int i = 0; i < classpathElements.size(); i++) {
                File file = new File(classpathElements.get(i));
                classpathUrls[i] = file.toURI().toURL();
            }

            // 使用当前线程上下文类加载器作为父加载器，更适配Maven插件环境
            URLClassLoader urlClassLoader = new URLClassLoader(classpathUrls, Thread.currentThread().getContextClassLoader());

            // 加载目标类
            Class<?> targetClass = urlClassLoader.loadClass("com.x.y.z.MyClass");
            getLog().info("成功加载类: " + targetClass.getName());

            // 后续可以解析类结构、字段、方法等
            // ...

        } catch (Exception e) {
            getLog().error("类加载失败", e);
        }
    }
}

额外注意事项 #

• 处理空值风险：原代码中optional.get()未做空判断，若target目录下无jar会直接抛出异常，修改后的代码已无需此逻辑，但日常编码中需注意这类空指针风险。
• 类加载器资源释放：Java 7及以上版本的URLClassLoader支持close()方法，使用完后建议调用以释放资源。
• Maven依赖范围：确保目标类所在的依赖配置为compile或runtime范围，这样才会被纳入getCompileClasspathElements()返回的类路径中。

内容的提问来源于stack exchange，提问作者jerry.yang