在上一篇中,我们深入剖析了 SpringApplicationRunListener.environmentPrepared() 这一关键扩展点,实现了环境合法性校验、启动上下文传递、多环境隔离兜底与配置动态增强等高阶能力。今天,我们将进入 Spring Boot 启动生命周期的下一个重要阶段——容器初始化前的关键扩展点:ApplicationContextInitializer。
一、什么是 ApplicationContextInitializer?
ApplicationContextInitializer 是 Spring 框架原生提供的接口,在 Spring Boot 中被广泛用于 在 ApplicationContext 初始化完成前、刷新前(refresh 前)对容器进行定制化配置。其触发时机具有如下特征:
- 触发时机:
ApplicationContext已创建但尚未调用refresh(); - 核心状态:
Environment已完全准备就绪,所有配置已生效; - 执行顺序:晚于
environmentPrepared(),早于BeanFactoryPostProcessor; - 核心能力:可注册 Bean、修改 Bean 定义、设置容器属性、注入自定义逻辑。
✅ 核心价值:在容器刷新前对
ApplicationContext做最后的“预热”和“定制”,是实现容器级扩展、安全加固、AOP 注入、监控埋点等场景的核心入口。
二、场景 :容器安全加固(禁止危险 Bean 注入)
业务痛点
微服务架构下,部分第三方库或内部组件可能通过自动配置注入高危 Bean(如 Runtime、ScriptEngine、JndiTemplate),存在远程代码执行(RCE)风险。即使通过配置禁用,仍可能因依赖传递或版本升级被意外激活。
解决方案
利用 ApplicationContextInitializer 在容器刷新前扫描并移除/替换高危 Bean 定义,从源头阻断安全隐患。
实现代码
package com.example.demo.initializer;
import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.DefaultListableBeanFactory;
import org.springframework.context.ApplicationContextInitializer;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider;
import org.springframework.core.type.filter.AssignableTypeFilter;
import org.springframework.jndi.JndiTemplate;
import org.springframework.util.StringUtils;
import javax.naming.InitialContext;
import javax.script.ScriptEngine;
import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;
/**
* 容器安全加固初始化器
*/
public class SecurityHardeningInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
// 高危类黑名单(可根据安全策略动态加载)
private static final Set<String> DANGEROUS_BEAN_TYPES = new HashSet<>(Arrays.asList(
"javax.script.ScriptEngine",
"javax.naming.InitialContext",
"org.springframework.jndi.JndiTemplate",
"java.lang.Runtime"
));
@Override
public void initialize(ConfigurableApplicationContext applicationContext) {
System.out.println("[安全加固] 开始扫描并清理高危 Bean 定义");
//构造高危类黑名单的类
if (applicationContext instanceof BeanDefinitionRegistry registry) {
BeanDefinitionBuilder builder1 = BeanDefinitionBuilder.genericBeanDefinition(ScriptEngine.class);
BeanDefinitionBuilder builder2 = BeanDefinitionBuilder.genericBeanDefinition(InitialContext.class);
BeanDefinitionBuilder builder3 = BeanDefinitionBuilder.genericBeanDefinition(JndiTemplate.class);
BeanDefinitionBuilder builder4 = BeanDefinitionBuilder.genericBeanDefinition(Runtime.class);
// 注册BeanDefinition
registry.registerBeanDefinition("scriptEngine", builder1.getBeanDefinition());
registry.registerBeanDefinition("initialContext", builder2.getBeanDefinition());
registry.registerBeanDefinition("jndiTemplate", builder3.getBeanDefinition());
registry.registerBeanDefinition("runtime", builder4.getBeanDefinition());
}
DefaultListableBeanFactory beanFactory = (DefaultListableBeanFactory) applicationContext.getBeanFactory();
String[] beanNames = beanFactory.getBeanDefinitionNames();
for (String beanName : beanNames) {
var beanDefinition = beanFactory.getBeanDefinition(beanName);
String beanClassName = beanDefinition.getBeanClassName();
if (StringUtils.hasText(beanClassName) && DANGEROUS_BEAN_TYPES.contains(beanClassName)) {
System.err.printf("[安全加固] 检测到高危 Bean:%s(类型:%s),已移除!%n", beanName, beanClassName);
beanFactory.removeBeanDefinition(beanName);
}
}
// 禁止通过 @Import 或 ComponentScan 自动注册高危类
disableDangerousScanning(applicationContext);
System.out.println("[安全加固] 容器安全加固完成");
}
/**
* 禁用高危类的组件扫描(防止后续自动注册)
*/
private void disableDangerousScanning(ConfigurableApplicationContext context) {
ClassPathScanningCandidateComponentProvider scanner =
new ClassPathScanningCandidateComponentProvider(false);
scanner.addIncludeFilter(new AssignableTypeFilter(Runtime.class));
// 实际生产中可结合 AspectJ 或字节码工具拦截,此处仅作示意
System.out.println("[安全加固] 已禁用高危类自动扫描(需配合编译期检查)");
}
}
配置方式(任选其一)
方式 1:通过 spring.factories
# resources/META-INF/spring.factories
org.springframework.context.ApplicationContextInitializer=\
com.example.demo.initializer.SecurityHardeningInitializer
方式 2:通过主类显式注册
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication app = new SpringApplication(DemoApplication.class);
app.addInitializers(new SecurityHardeningInitializer());
app.run(args);
}
}
输出结果
. ____ _ __ _ _
/\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )___ | '_ | '_| | '_ / _` | \ \ \ \
\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |___, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v3.5.8)
[安全加固] 开始扫描并清理高危 Bean 定义
[安全加固] 已禁用高危类自动扫描(需配合编译期检查)
[安全加固] 容器安全加固完成
2025-12-17T23:58:06.580+08:00 INFO 11158 --- [ main] com.example.demo.DemoApplication : Starting DemoApplication using Java 21.0.9 with PID 11158 (/Users/wangmingfei/Documents/个人/05 java天梯之路/01 源码/03 每日打卡系列/daily-check-in/springboot钩子/demo/target/classes started by wangmingfei in /Users/wangmingfei/Documents/个人/05 java天梯之路/01 源码/03 每日打卡系列/daily-check-in/springboot钩子/demo)
2025-12-17T23:58:06.581+08:00 INFO 11158 --- [ main] com.example.demo.DemoApplication : The following 1 profile is active: "prod"
[安全加固] 检测到高危 Bean:scriptEngine(类型:javax.script.ScriptEngine),已移除!
[安全加固] 检测到高危 Bean:initialContext(类型:javax.naming.InitialContext),已移除!
[安全加固] 检测到高危 Bean:jndiTemplate(类型:org.springframework.jndi.JndiTemplate),已移除!
[安全加固] 检测到高危 Bean:runtime(类型:java.lang.Runtime),已移除!
2025-12-17T23:58:06.876+08:00 INFO 11158 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port 8080 (http)
2025-12-17T23:58:06.882+08:00 INFO 11158 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2025-12-17T23:58:06.883+08:00 INFO 11158 --- [ main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.49]
2025-12-17T23:58:06.901+08:00 INFO 11158 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
2025-12-17T23:58:06.901+08:00 INFO 11158 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 303 ms
2025-12-17T23:58:07.038+08:00 INFO 11158 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http) with context path '/'
2025-12-17T23:58:07.042+08:00 INFO 11158 --- [ main] com.example.demo.DemoApplication : Started DemoApplication in 0.645 seconds (process running for 0.792)
生产价值
- 从容器层面拦截高危 Bean,比运行时检测更早、更彻底;
- 防止因依赖升级或配置错误引入安全漏洞;
三、总结
ApplicationContextInitializer 是 Spring Boot 启动流程中 连接环境准备与容器刷新的关键桥梁,它与 environmentPrepared() 形成“环境 → 容器”的完整扩展链路,是构建企业级高可靠、高安全、高可观测性应用不可或缺的一环。
📌 关注我,每天 5 分钟,带你从 Java 小白变身编程高手!
👉 点赞 + 关注 + 转发,让更多小伙伴一起进步!
👉 私信 "SpringBoot 钩子源码" 获取完整源码!