applicationcontextinitializer 可在 spring 容器刷新前向 environment 动态注入自定义配置源,因其执行早于 bean 加载与 profile 激活,故能影响全部配置解析;典型方式包括从 map、properties 文件或外部系统构建 propertysource 并通过 addfirst()/addlast() 注入,注册可通过 spring.factories、application.properties 或编程式完成。

可以在项目启动初期、Spring 容器刷新前,通过 ApplicationContextInitializer 向 Environment 中添加自定义配置源(PropertySource),实现配置的动态注入。关键在于:它执行时机早于 Bean 加载和 Profile 激活,因此能影响后续所有配置解析逻辑。
明确执行时机与作用边界
ApplicationContextInitializer#initialize() 在 ConfigurableApplicationContext.refresh() 调用之前触发,此时:
- BeanDefinition 尚未加载,
@Configuration类还未解析 -
Environment已创建但未冻结,PropertySources可安全增删 - 所有 Profile(如
spring.profiles.active)尚未生效,所以你添加的 PropertySource 可参与 Profile 判定
往 Environment 添加自定义配置源的典型方式
核心是获取 applicationContext.getEnvironment(),然后调用 getPropertySources().addFirst() 或 addLast() 注入新源。优先级很重要:addFirst() 的配置项会覆盖后加载的同名属性。
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
-
从 Map 构建 PropertySource:适合硬编码或运行时计算的键值对
Map<string object> props = Map.of("app.env", "dev", "feature.flag", "true");<br>environment.getPropertySources().addFirst(new MapPropertySource("my-init", props));</string> -
从 Properties 文件加载:适用于 classpath 下的
.properties文件Resource resource = new ClassPathResource("custom-config.properties");<br>Properties props = PropertiesLoaderUtils.loadProperties(resource);<br>environment.getPropertySources().addFirst(new PropertiesPropertySource("custom-file", props)); -
从外部系统拉取配置:比如读取 Consul、Nacos 或本地 JSON 配置
先解析为Map<string object></string>,再封装成MapPropertySource即可
注册初始化器的三种常用方式
确保你的初始化器类被 Spring Boot 正确识别并执行:
-
通过
spring.factories(推荐,自动装配)
在src/main/resources/META-INF/spring.factories中添加:org.springframework.context.ApplicationContextInitializer=\<br> com.example.MyCustomInitializer
-
通过
application.propertiescontext.initializer.classes=com.example.MyCustomInitializer -
编程式注册(适合测试或主类定制)
new SpringApplicationBuilder(Application.class)<br> .initializers(new MyCustomInitializer())<br> .run(args);
注意顺序与冲突处理
多个初始化器按 @Order 或实现 Ordered 接口控制执行顺序;PropertySource 的插入位置决定覆盖优先级:
- 使用
addFirst()可确保你的配置优先于application.yml和命令行参数生效(除非后者用了--强制覆盖) - 若需低优先级(仅作兜底),改用
addLast() - 避免重复添加同名 PropertySource(可通过
getPropertySources().contains("my-init")判断)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










