如何配置Spring Boot从自定义路径加载自定义Jar插件？

下面是几种实用的落地方案：

1. 启动时通过参数指定自定义Jar路径 #

Spring Boot提供了loader.path参数，可直接在启动时指定额外的Jar目录或单个Jar文件：

java -jar your-spring-boot-app.jar --loader.path=/opt/custom-plugins/,/opt/single-plugin.jar

如果要批量加载某个目录下的所有Jar，直接指定目录路径即可，Spring Boot会自动扫描并加载该目录下的所有Jar文件。

也可以通过扩展系统类路径实现：

java -cp "your-spring-boot-app.jar:/opt/custom-plugins/*" org.springframework.boot.loader.JarLauncher

2. 自定义ClassLoader加载Jar #

编写自定义类加载器，在Spring应用启动前手动加载指定路径的Jar，示例代码：

public class CustomJarClassLoader extends URLClassLoader {
    public CustomJarClassLoader(URL[] urls, ClassLoader parent) {
        super(urls, parent);
    }

    public static void loadJars(String jarDir) throws IOException {
        File dir = new File(jarDir);
        File[] jars = dir.listFiles(file -> file.getName().endsWith(".jar"));
        if (jars != null) {
            URL[] urls = Arrays.stream(jars)
                    .map(file -> {
                        try {
                            return file.toURI().toURL();
                        } catch (MalformedURLException e) {
                            throw new RuntimeException(e);
                        }
                    })
                    .toArray(URL[]::new);
            CustomJarClassLoader classLoader = new CustomJarClassLoader(urls, Thread.currentThread().getContextClassLoader());
            Thread.currentThread().setContextClassLoader(classLoader);
        }
    }
}

在启动类main方法中先执行加载逻辑：

public static void main(String[] args) throws IOException {
    // 加载自定义路径下的Jar
    CustomJarClassLoader.loadJars("/opt/custom-plugins/");
    // 启动Spring Boot应用
    SpringApplication.run(YourApplication.class, args);
}

3. 动态注册Jar中的Bean #

如果需要细粒度控制（比如只加载Jar中的特定类），可以实现ApplicationContextInitializer，在Spring容器初始化时扫描并注册Bean：

public class PluginInitializer implements ApplicationContextInitializer<GenericApplicationContext> {
    @Override
    public void initialize(GenericApplicationContext context) {
        try {
            // 加载目标Jar
            URL jarUrl = new File("/opt/custom-plugins/your-plugin.jar").toURI().toURL();
            URLClassLoader classLoader = new URLClassLoader(new URL[]{jarUrl}, context.getClassLoader());
            
            // 加载Jar中的目标类
            Class<?> pluginClass = classLoader.loadClass("com.example.plugin.YourPluginClass");
            
            // 注册为Spring Bean
            context.registerBean("customPlugin", pluginClass);
        } catch (Exception e) {
            throw new RuntimeException("加载自定义插件失败", e);
        }
    }
}

在resources/META-INF/spring.factories中注册该初始化器：

org.springframework.context.ApplicationContextInitializer=com.example.PluginInitializer

4. 扩展组件扫描范围 #

如果自定义Jar中的类已标注@Component等Spring注解，可通过@ComponentScan扩展扫描路径，直接包含Jar中的包：

@SpringBootApplication
@ComponentScan(basePackages = {"com.example.mainapp", "com.example.plugin"})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这种方式需要结合前面的启动参数或自定义ClassLoader，确保Jar已被加入类路径。

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