SpringBoot 3.X中如何使用第三方库返回值为void的@Bean

问题原因 #

Spring Boot 3.x基于Spring Framework 6.x，该版本开始严格禁止@Bean方法返回void——这是框架的兼容性变更，而Spring Boot 2.x（基于Spring Framework 5.x）允许这种写法（仅作为初始化逻辑执行，不注册Bean）。第三方依赖的配置类违反了这一新规则，导致启动报错。

可行解决方案（无需修改第三方代码） #

方案1：排除第三方问题配置类，手动执行初始化逻辑 #

1. 定位问题配置类
   先找到包含performUpdateForAllInstances方法的@Configuration类全类名（例如com.thirdparty.ThirdPartyConfig）。

2. 排除该配置类的自动扫描
   修改你的@SpringBootApplication注解，通过exclude属性排除这个配置类：

@SpringBootApplication(
    scanBasePackages = "package.path.from.third.party.*",
    exclude = com.thirdparty.ThirdPartyConfig.class
)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

如果无法直接引用该类（比如依赖未提供源码），可以用excludeFilters按类型过滤：

@SpringBootApplication(
    scanBasePackages = "package.path.from.third.party.*",
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.ASSIGNABLE_TYPE,
        value = Class.forName("com.thirdparty.ThirdPartyConfig")
    )
)

3. 手动执行原初始化逻辑
   自己编写配置类，通过@PostConstruct调用第三方的初始化方法：

@Configuration
public class ThirdPartyInitializer {
    // 注入该方法需要的依赖（如果有）
    @Autowired(required = false)
    private SomeDependency someDependency;

    @PostConstruct
    public void runUpdateLogic() throws Exception {
        // 直接调用第三方的初始化方法
        new com.thirdparty.ThirdPartyConfig().performUpdateForAllInstances();
        // 若方法依赖Spring容器内的Bean，需传入对应实例
        // new com.thirdparty.ThirdPartyConfig().performUpdateForAllInstances(someDependency);
    }
}

方案2：拦截并移除问题Bean定义（保留配置类其他Bean） #

如果该配置类还有其他有用的@Bean，不能直接排除整个类，可以通过自定义BeanDefinitionRegistryPostProcessor移除有问题的Bean定义：

@Component
public class FixVoidBeanProcessor implements BeanDefinitionRegistryPostProcessor {
    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        // 移除问题Bean的定义，参数为原@Bean方法的名称
        if (registry.containsBeanDefinition("performUpdateForAllInstances")) {
            registry.removeBeanDefinition("performUpdateForAllInstances");
        }
    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
        // 手动执行原方法逻辑
        try {
            beanFactory.getBean(com.thirdparty.ThirdPartyConfig.class).performUpdateForAllInstances();
        } catch (Exception e) {
            throw new RuntimeException("执行第三方更新逻辑失败", e);
        }
    }
}

注意事项 #

• 手动执行逻辑时，要确保原方法依赖的所有Bean都已在Spring容器中初始化（@PostConstruct在当前Bean初始化后执行，若依赖其他Bean需保证初始化顺序）。
• 如果第三方的performUpdateForAllInstances是单例执行逻辑，手动调用时要避免重复执行。

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