运行时动态加载SDK JAR包（非反射），ClassLoader是否适用？

我在用第三方厂商的SDK，手动提供JAR包时运行正常。现在需要从配置文件或系统环境变量指定的自定义路径里，在执行封装SDK代码的类之前动态加载该JAR包（非反射用途）。我写了一段基于URLClassLoader的代码，但不确定哪种类加载方法能真正生效，也不确定用的API对不对。同事说ClassLoader是正确选择，但我之前误以为它只用于反射场景。另外我了解到Java agent方案还没尝试，想确认ClassLoader是否适配我的场景，要是不适用的话希望知道其他可行方案。

附上我的代码：

public void load(String path) {
        String className = getClassName();
        if (Utils.isNullOrEmpty(path)) {
            return;
        }
        if (initialized) {
            System.out.println("Already loaded classe " + className);
            return;
        }
        try {
            System.out.println("path = " + path);
            URL[] jars = new URL[]{new URL("file", "", path)};
            System.out.println("url = " + jars[0]);
            try (URLClassLoader classLoader = URLClassLoader.newInstance(jars)) {
                classLoader.loadClass(className);
                System.out.println("classLoader.loadClass(getClassName()) worked");
                Class.forName(className);
                System.out.println("Class.forName(getClassName()) worked");
                ClassLoader.getSystemClassLoader().loadClass(className);
                System.out.println("ClassLoader.getSystemClassLoader().loadClass(getClassName()) worked");

                initialized = true;
                log.debug("Succeeded loading class ");
            } catch (IOException e) {
                log.error("Failed to load SDK from path: {}. Error: {}", path, e.getMessage());
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
                System.out.println("Error to load: " + e.getMessage());
            }

        } catch (MalformedURLException e) {
            System.out.println("Failed to load SDK from path: {}. Error: {} " + path + e.getMessage());
        }
    }

一、ClassLoader完全适配你的场景 #

ClassLoader绝非仅用于反射，它是Java类加载机制的核心组件——所有类的加载都依赖ClassLoader。你的场景属于动态扩展类路径，用ClassLoader是标准解决方案，同事的判断没问题。

二、现有代码的核心问题 #

你当前的代码有几个关键缺陷，导致加载的类无法被后续业务代码正常使用：

1. 自定义ClassLoader仅局部有效：你创建的URLClassLoader是try-with-resources块里的局部变量，代码块执行完毕后ClassLoader会被关闭，加载的类也会失去有效引用。
2. 类加载方法的作用误解：
   • classLoader.loadClass(className)：仅用自定义ClassLoader加载了类，但这个类只能通过该ClassLoader访问，后续业务代码的类加载器（比如系统类加载器）找不到它。
   • Class.forName(className)：默认使用当前类的类加载器（也就是调用load方法的类的类加载器），如果这个类加载器的路径里没有目标JAR，必然加载失败——你看到的"worked"说明目标JAR已经在系统类路径里了，不是动态加载的效果。
   • ClassLoader.getSystemClassLoader().loadClass(className)：用系统类加载器加载，同样依赖JAR在系统类路径，和动态加载无关。

三、正确的动态加载方式 #

要让后续业务代码能正常使用动态加载的类，需要让业务代码的类加载器能找到这个类，有两种可行方式：

方式1：替换线程上下文类加载器 #

Java很多框架默认会用线程上下文类加载器加载类，你可以把自定义的URLClassLoader设置为当前线程的上下文类加载器：

public void load(String path) {
    String className = getClassName();
    if (Utils.isNullOrEmpty(path) || initialized) {
        return;
    }
    try {
        // 修正file协议URL格式，正确格式为file:/xxx/xxx.jar
        URL jarUrl = new URL("file:" + path);
        // 将当前线程上下文类加载器作为父加载器，遵循双亲委派模型
        URLClassLoader customLoader = new URLClassLoader(new URL[]{jarUrl}, Thread.currentThread().getContextClassLoader());
        // 设置当前线程的上下文类加载器为自定义加载器
        Thread.currentThread().setContextClassLoader(customLoader);
        // 提前加载类，确保后续使用时能直接找到
        customLoader.loadClass(className);
        initialized = true;
        log.debug("SDK类加载成功");
    } catch (MalformedURLException | ClassNotFoundException e) {
        log.error("加载SDK失败，路径：{}，错误：{}", path, e.getMessage(), e);
    }
}

这种方式无需修改业务代码的类加载逻辑，只要业务代码依赖线程上下文类加载器即可。

方式2：扩展系统类加载器（不推荐但可行） #

通过反射修改系统类加载器（AppClassLoader）的URLClassPath，把目标JAR添加进去，这样后续业务代码用默认系统类加载器就能找到类：

public void load(String path) {
    String className = getClassName();
    if (Utils.isNullOrEmpty(path) || initialized) {
        return;
    }
    try {
        URL jarUrl = new URL("file:" + path);
        ClassLoader systemLoader = ClassLoader.getSystemClassLoader();
        // 反射获取URLClassLoader的ucp字段
        Field ucpField = URLClassLoader.class.getDeclaredField("ucp");
        ucpField.setAccessible(true);
        URLClassPath ucp = (URLClassPath) ucpField.get(systemLoader);
        // 反射调用addURL方法添加jar路径
        Method addUrlMethod = URLClassPath.class.getDeclaredMethod("addURL", URL.class);
        addUrlMethod.setAccessible(true);
        addUrlMethod.invoke(ucp, jarUrl);
        // 验证加载
        systemLoader.loadClass(className);
        initialized = true;
        log.debug("SDK类加载成功");
    } catch (Exception e) {
        log.error("加载SDK失败，路径：{}，错误：{}", path, e.getMessage(), e);
    }
}

这种方式的好处是业务代码完全无需调整，但缺点是依赖JDK内部实现，不同JDK版本可能存在兼容问题。

四、Java Agent方案的适用场景 #

如果你的应用是无法修改启动参数的第三方应用，或者需要在所有类加载前拦截修改，Java Agent是合适的选择——它可以通过-javaagent参数在JVM启动时注入，动态修改类加载路径。但如果是你自己开发的应用，用ClassLoader方案更简单直接，没必要用Java Agent。

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