pf4j spring 集成幾個(gè)問題記錄

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

文章介紹了在使用pf4j和Spring框架時(shí)遇到的一些問題及其解決方法,包括類加載器沖突、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 ，在插件項(xiàng)目中對(duì)于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'

與上邊一個(gè)問題一樣，不然會(huì)有莫名的問題

bean 注入問題

官方提供了SpringPluin 抽象，此類可以解決spring context 的創(chuàng)建以及一些依賴處理，一般的玩法是自己創(chuàng)建一個(gè)，同時(shí)對(duì)于需要
注意的beans在此對(duì)象中注冊(cè)
參考
PluginBConfig 為一個(gè)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 共享問題
場(chǎng)景，比如bootstrap 提供datasource，插件直接使用此datasource
默認(rèn)pf4j spring 只能使用自己插件里邊包含的bean，對(duì)于添加了Extension 注解的擴(kuò)展類，可以暴露為一個(gè)直接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 中注冊(cè)，對(duì)于插件同時(shí)也包含一個(gè)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;
    }
}

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