动态加载库时加载Bootstrap类出现NoClassDefFoundError问题

核心问题 #

加载Bootstrap类时，其依赖的org.eclipse.jgit.transport.CredentialsProvider无法被找到，本质是类加载器的委托链出现断裂，导致依赖类无法通过预期的加载器被解析。

可能原因 #

1. 自定义DelegatingClassLoader的逻辑缺陷：若其未正确处理类加载的归属、resolve参数或委托顺序，会导致依赖类的查找路径异常。
2. 类加载器负缓存影响：系统类加载器（rootLoader）若曾尝试加载JGit类失败，会缓存该失败状态，后续委托时直接抛出异常。
3. 冗余的类加载器包装：不必要的DelegatingClassLoader包装打破了标准的双亲委派逻辑，导致类加载路径混乱。

解决方案 #

方案一：简化类加载器结构（推荐） #

直接使用嵌套的URLClassLoader遵循标准双亲委派规则，去掉冗余的DelegatingClassLoader：

//////// Main.java /////////
/* ... public static void main(String[] args) { */

// 下载库文件，获取本地JAR的URL数组
URL[] libraryUrls = ...;

// 创建加载第三方库的ClassLoader，父类绑定系统类加载器
ClassLoader libraryLoader = new URLClassLoader(libraryUrls, Main.class.getClassLoader());

// 验证库加载成功
Class.forName("org.eclipse.jgit.transport.CredentialsProvider", true, libraryLoader);

// 获取Bootstrap类所在JAR的URL
ProtectionDomain domain = Main.class.getProtectionDomain();
CodeSource source = domain.getCodeSource();
URL bootstrapJarUrl = source.getLocation();

// 创建加载Bootstrap的ClassLoader，父类绑定libraryLoader
ClassLoader appLoader = new URLClassLoader(new URL[]{bootstrapJarUrl}, libraryLoader);

// 加载并执行Bootstrap类
Class<?> bootstrap = Class.forName("my.package.Bootstrap", true, appLoader);
bootstrap.getMethod("execute", String[].class).invoke(null, (Object) args);

/* } ... */

逻辑说明：

• appLoader的父类是libraryLoader，加载Bootstrap时会先委托父类查找第三方库类；
• libraryLoader的父类是系统类加载器，保证JDK核心类能被正常加载；
• 完全遵循双亲委派规则，避免自定义加载器带来的逻辑混乱。

方案二：修复DelegatingClassLoader实现 #

若必须使用自定义加载器，需修正其loadClass方法，确保线程安全、正确处理resolve参数及委托顺序：

public class DelegatingClassLoader extends ClassLoader {
    private final ClassLoader delegate;

    public DelegatingClassLoader(ClassLoader delegate, ClassLoader parent) {
        super(parent);
        this.delegate = delegate;
    }

    @Override
    protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException {
        synchronized (getClassLoadingLock(name)) {
            // 检查是否已加载过该类
            Class<?> loadedClass = findLoadedClass(name);
            if (loadedClass == null) {
                try {
                    // 优先委托给指定的delegate加载
                    loadedClass = delegate.loadClass(name);
                } catch (ClassNotFoundException e) {
                    // delegate加载失败，委托给父类加载器
                    loadedClass = super.loadClass(name, false);
                }
            }
            // 处理类的链接逻辑
            if (resolve) {
                resolveClass(loadedClass);
            }
            return loadedClass;
        }
    }
}

方案三：绕过系统类加载器负缓存 #

若系统类加载器已缓存JGit类的加载失败状态，可将libraryLoader的父类设为null（绑定扩展类加载器），绕过系统类加载器的负缓存：

ClassLoader libraryLoader = new URLClassLoader(libraryUrls, null);

注意：此方式需确保JDK核心类能通过扩展类加载器正常加载，仅在明确场景下使用。

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