pf4j spring 集成幾個問題記錄

更新時間：2026年03月16日 09:39:41 作者：Jeffcky

文章介紹了在使用pf4j和Spring框架時遇到的一些問題及其解決方法,包括類加載器沖突、Bean注入問題、父子Spring上下文的使用以及擴(kuò)展類的處理,感興趣的朋友跟隨小編一起看看吧

問題

Caused by: java.lang.LinkageError: loader constraint violation: loader (instance of org/pf4j/PluginClassLoader) previously initiated loading for a different type with name "org/springframework/context/ApplicationContext"

移除spring core ，在插件項目中對于spring 的依賴設(shè)置為provide

org.springframework.beans.factory.BeanNotOfRequiredTypeException: Bean named 'jdbcTemplate' is expected to be of type 'org.springframework.jdbc.core.JdbcTemplate' but was actually of type 'org.springframework.jdbc.core.JdbcTemplate'

與上邊一個問題一樣，不然會有莫名的問題

bean 注入問題

官方提供了SpringPluin 抽象，此類可以解決spring context 的創(chuàng)建以及一些依賴處理，一般的玩法是自己創(chuàng)建一個，同時對于需要
注意的beans在此對象中注冊
參考
PluginBConfig 為一個Configuration ，可以聲明我們需要的bea

public class PluginB extends SpringPlugin {
    public PluginB(PluginWrapper wrapper) {
        super(wrapper);
    }
    @Override
    protected ApplicationContext createApplicationContext() {
        AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext();
        applicationContext.setClassLoader(getWrapper().getPluginClassLoader());
        applicationContext.register(PluginBConfig.class);
        applicationContext.refresh();
        return applicationContext;
    }
}

基于父子spring context 解決bean 共享問題
場景，比如bootstrap 提供datasource，插件直接使用此datasource
默認(rèn)pf4j spring 只能使用自己插件里邊包含的bean，對于添加了Extension 注解的擴(kuò)展類，可以暴露為一個直接spring bean
pf4j-spring/src/main/java/org/pf4j/spring/ExtensionsInjector.java

protected void registerExtension(Class<?> extensionClass) {
    Map<String, ?> extensionBeanMap = springPluginManager.getApplicationContext().getBeansOfType(extensionClass);
    if (extensionBeanMap.isEmpty()) {
        Object extension = springPluginManager.getExtensionFactory().create(extensionClass);
        beanFactory.registerSingleton(extensionClass.getName(), extension); // 使用了bootstrap 的applicationcontext
    } else {
        log.debug("Bean registeration aborted! Extension '{}' already existed as bean!", extensionClass.getName());
    }
}

此擴(kuò)展在bootstrap 的applicationcontext 中注冊，對于插件同時也包含一個createApplicationContext，在此處我們可以i基于
spring 的context 父子關(guān)系解決插件共享bootstrap bean 的問題
參考代碼

public class pluginC extends SpringPlugin {
    public pluginC(PluginWrapper wrapper) {
        super(wrapper);
    }
    @Override
    protected ApplicationContext createApplicationContext() {
         // 先獲取SpringPluginManager 的ApplicationContext，也就是bootstrap 的ApplicationContext
        ApplicationContext applicationContextRoot  = ((SpringPluginManager)getWrapper().getPluginManager()).getApplicationContext();
        AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext();
        applicationContext.setClassLoader(getWrapper().getPluginClassLoader());
        // 設(shè)置父applicationtext
        applicationContext.setParent(applicationContextRoot);
        applicationContext.register(PluginCConfig.class);
        applicationContext.refresh();
        return applicationContext;
    }
}

注意一個問題，將spring 依賴設(shè)置為provide，不然會有上邊2的問題，注意共享bean是子能訪問父，父不能訪問子（spring 約定）
如果需要訪問，推薦放到服務(wù)契約中，在插件中開發(fā)實現(xiàn)，讓SpringPluginManager 自己進(jìn)行bean 注冊到父中，而且此bean在插件中
也可以直接訪問