Spring Boot：如何优先加载外部Jar包中自动配置类的Bean

我之前也碰到过一模一样的问题——自定义的优雅停机自动配置打包在公共库，引入项目后总是赶在Tomcat初始化完成才加载，结果拿不到Connector抛出空指针。结合你的场景（无外部Bean依赖，只想优先加载），给你几个靠谱的解决方案：

方案1：用@AutoConfigureBefore精准控制加载顺序 #

Spring Boot允许通过@AutoConfigureBefore注解指定当前自动配置类在某个核心自动配置类之前加载。你的问题核心是要抢在Tomcat的WebServerFactory自动配置类之前初始化Bean，直接给GracefulShutdownConfig加上这个注解即可：

@Configuration
@AutoConfigureBefore(TomcatServletWebServerFactoryAutoConfiguration.class)
public class GracefulShutdownConfig {
    @Bean
    public GracefulShutdown gracefulShutdown() {
        return new GracefulShutdown();
    }

    @Bean
    public TomcatServletWebServerFactory webServerFactory(final GracefulShutdown gracefulShutdown) {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
        factory.addConnectorCustomizers(gracefulShutdown);
        return factory;
    }
}

注意把返回类型从WebServerFactory改为TomcatServletWebServerFactory，这样Spring会优先使用你定义的Bean，覆盖默认的实例。这个方案精准直接，但和Tomcat强绑定，若后续切换到Jetty/Undertow需要调整。

方案2：改用WebServerFactoryCustomizer（推荐） #

Spring Boot提供了WebServerFactoryCustomizer接口，专门用于在WebServerFactory初始化前做定制化操作，时机非常合适。你可以重构代码，复用Spring Boot默认的Factory逻辑：

@Configuration
public class GracefulShutdownConfig {
    @Bean
    public GracefulShutdown gracefulShutdown() {
        return new GracefulShutdown();
    }

    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> tomcatGracefulShutdownCustomizer(GracefulShutdown gracefulShutdown) {
        return factory -> factory.addConnectorCustomizers(gracefulShutdown);
    }
}

这个方案的优势很明显：

• 不需要自己创建TomcatServletWebServerFactory Bean，完全复用框架默认配置
• 自动适配WebServer初始化时机，不管是默认Factory还是自定义Factory都会被处理
• 后续切换Web服务器时，只需修改自定义器的泛型类型（比如JettyServletWebServerFactory），扩展性更强

方案3：全局调整自动配置优先级 #

如果前两个方案不适用，还可以用@Order或@Priority给自动配置类设置最高优先级：

@Configuration
@Order(Ordered.HIGHEST_PRECEDENCE)
public class GracefulShutdownConfig {
    // ... 原有Bean定义 ...
}

不过这个方案是全局优先级调整，可能影响其他自动配置类的加载顺序，不如前两个方案精准，仅作为备选。

总结下来，方案2最符合Spring Boot扩展规范，也是最稳妥的选择，推荐优先尝试；若项目固定使用Tomcat，方案1也能快速解决问题。

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