Spring Boot 2.7.7/3中如何注册ApplicationContextInitializer

为什么直接放入AutoConfiguration.imports无效 #

org.springframework.boot.autoconfigure.AutoConfiguration.imports文件的作用是让Spring Boot自动加载标注了@AutoConfiguration的配置类，而ApplicationContextInitializer属于应用上下文初始化的扩展点，并非自动配置类范畴，直接将其全类名写入该文件不会触发initialize方法执行。

正确注册方式 #

方式一：在自定义自动配置类中通过@Bean注册

这是和你现有自动配置体系最契合的方式，在已有的@AutoConfiguration类中直接声明ApplicationContextInitializer类型的Bean即可：

@AutoConfiguration
public class MyCustomAutoConfiguration {

    @Bean
    public ApplicationContextInitializer<ConfigurableApplicationContext> myInitializer() {
        return context -> {
            // 在这里编写初始化逻辑
            // 例如读取配置、注册监听器等
            Environment env = context.getEnvironment();
            String appName = env.getProperty("spring.application.name");
            System.out.println("初始化上下文，应用名称：" + appName);
        };
    }
}

将这个自动配置类的全类名写入AutoConfiguration.imports文件，Spring Boot启动时会加载该配置类，注册的ApplicationContextInitializer会在上下文初始化阶段自动执行initialize方法。

方式二：使用spring.factories文件声明

这种方式无需依赖自动配置类，直接通过Spring的工厂加载机制注册，2.7.7和3.x版本都兼容：

1. 实现ApplicationContextInitializer接口：

public class MyCustomInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        // 初始化逻辑
    }
}

2. 在项目的META-INF/spring.factories文件中添加如下配置：

org.springframework.context.ApplicationContextInitializer=\
com.example.MyCustomInitializer

（注意替换为你自己的初始化器全类名，多个初始化器用逗号分隔）

注意事项 #

• ApplicationContextInitializer的执行时机较早，此时容器内大部分Bean尚未完成初始化，避免在方法内依赖未初始化的Bean，如需获取配置可通过context.getEnvironment()获取。
• Spring Boot 3.x与2.7.7在ApplicationContextInitializer的注册逻辑上无核心差异，仅需注意3.x要求Java 17+，以及依赖的Spring框架版本兼容性。

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