Spring Boot集成Togglz遇启动警告及重复启动问题求助

我之前在项目里也碰到过一模一样的问题，折腾了好一阵子才搞明白根源，咱们一步步来拆解解决：

先搞懂警告的原因 #

那个WARN o.t.s.l.TogglzApplicationContextBinderApplicationListener - ApplicationContext already bound to current context class loader, releasing it first警告，本质是Togglz的上下文绑定机制在作怪：

• Togglz会把Spring的ApplicationContext绑定到当前类加载器，方便后续获取配置
• 如果类加载器已经绑定过一个ApplicationContext，它就会先释放旧的再绑定新的
• 这种情况几乎都是Togglz相关配置重复初始化导致的——要么是你自定义的配置类和Spring Boot Starter的自动配置冲突，要么是多个配置类重复注册了Togglz的Bean

而你看到的Spring Banner重复显示，确实和这个有关：每次ApplicationContext启动都会打印Banner，重复绑定就意味着上下文被初始化了多次。

具体解决步骤 #

1. 避免Togglz Bean的重复注册 #

检查你的自定义配置类，如果手动创建了FeatureManager、TogglzConfiguration这类Bean，一定要加上@ConditionalOnMissingBean注解，确保只有当Spring容器里没有对应Bean时才会创建，避免和Starter的自动配置冲突：

@Configuration
public class CustomTogglzConfig {

    @Bean
    @ConditionalOnMissingBean
    public FeatureManager featureManager(TogglzConfiguration togglzConfig) {
        return new FeatureManagerBuilder()
                .togglzConfig(togglzConfig)
                .build();
    }

    // 其他Togglz相关Bean也同理加上@ConditionalOnMissingBean
}

2. 按需禁用Togglz自动配置 #

如果你需要完全自定义Togglz的配置，不想用Starter的默认自动配置，直接在application.yml里排除自动配置类即可：

spring:
  autoconfigure:
    exclude: org.togglz.spring.boot.autoconfigure.TogglzAutoConfiguration

这样就能彻底避免自动配置和自定义配置的冲突，从根源上解决重复绑定的问题。

3. 验证上下文是否真的重复启动 #

为了确认Banner重复是不是因为上下文多次初始化，可以在主类里加个简单的日志：

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        String pid = ManagementFactory.getRuntimeMXBean().getName();
        System.out.println("=== 启动应用，PID: " + pid + " ===");
        SpringApplication.run(YourApplication.class, args);
    }
}

如果控制台多次打印这个日志，说明确实是上下文被多次启动了，这时候要排查是不是测试类、第三方库或者自定义的监听器触发了额外的启动逻辑。

4. 直接处理类加载器绑定（可选） #

如果警告实在烦人，且确认不影响功能，可以在上下文刷新前手动解绑类加载器的绑定：

@Component
public class TogglzBindingFixer {

    @EventListener(ContextRefreshedEvent.class)
    public void fixDuplicateBinding() {
        TogglzApplicationContextBinder.unbindCurrentClassLoader();
    }
}

不过这个方法要谨慎使用，确保不会影响Togglz的正常功能。

总结 #

核心思路就是消除Togglz配置的重复初始化：要么用@ConditionalOnMissingBean让自定义配置和自动配置和平共存，要么完全禁用自动配置自己手动配置。解决了重复初始化的问题，警告和Banner重复的情况自然就消失了。

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