外观
A - Spring 机制测试与源码验证
适用版本:Spring Framework 6.x、Spring Boot 3.x、Java 17。测试 API 与自动配置测试工具的细节应按项目实际小版本核对。
建议读完 01 - 从 refresh() 读懂 Spring后阅读,并在后续每篇文章中复用本文方法。
摘要
加上事务注解后,接口返回了 200,能否说明事务已经提交?应用成功启动,能否说明自动配置按预期选择了 Bean?这些结果只覆盖了部分行为,不能替代对目标机制的直接检查。
本文先区分定义、对象、代理、调用和外部结果,再选择能够观察目标行为的最小测试环境。通过这一方法,可以把失败定位到具体阶段,并用源码调试解释该阶段为什么产生当前结果。
1. 先定义要证明什么
Bean 是由 Spring 容器管理的对象;**BeanDefinition(Bean 定义)**是描述对象类型、创建方式和作用域等信息的元数据。容器根据定义创建对象并注入依赖,还可能在目标对象外包装代理,让方法调用先经过事务、缓存等额外逻辑。
同一个“Bean 可以使用”至少包含六个不同命题:
- BeanDefinition 已经注册;
- Bean 能够成功创建;
- 注入的是预期候选;
- 最终对象具有预期代理和 Advisor;
- 方法调用真正经过增强链;
- 数据库、缓存或响应产生了预期外部结果。
Advisor 描述一项增强及其适用规则;增强链是方法调用时依次执行的额外逻辑。定义存在不代表对象能创建,代理存在也不代表当前调用执行了事务逻辑。因此,只调用一次接口得到 200,无法分别证明上述命题。
测试前先写清“在什么条件下,观察什么结果”。例如,验证自动配置退让,就检查用户提供 Bean 后容器使用哪个对象;验证事务提交,就检查事务结束后数据库中的状态。断言,即测试中判断实际结果是否符合预期的检查,应直接对应这个目标。
2. 测试分层
| 目标 | 优先工具 | 不应由它证明什么 |
|---|---|---|
| 普通容器定义和生命周期 | AnnotationConfigApplicationContext | Boot 自动配置和 Web 环境 |
| 自动配置条件与退让 | ApplicationContextRunner | 完整应用启动性能 |
| 代理、事务与 Bean 协作 | Spring Test 集成上下文 | 真实网络和网关行为 |
| MVC 映射、参数和响应 | MockMvc | Servlet 容器端口、真实 Filter 容器注册和连接行为 |
| 完整 HTTP 请求链 | 随机端口集成测试 | 外部网关、DNS 和生产网络 |
| 启动性能与等待 | ApplicationStartup、JFR、线程 Dump | 单次采样不能证明稳定因果 |
这里的“上下文”指 ApplicationContext,即组织 Bean、配置和生命周期的应用容器。AnnotationConfigApplicationContext 用于加载注解配置;Boot 的 ApplicationContextRunner 用于按不同条件创建测试上下文;Spring Test 则负责测试与应用上下文的集成。自动配置“退让”是指用户已提供符合条件的组件时,自动配置不再创建默认组件。
MockMvc 在模拟的 Servlet 请求、响应环境中执行 MVC 处理链。随机端口集成测试则启动真实 Web 服务,由 HTTP 客户端发出请求。ApplicationStartup 记录容器启动步骤,JFR(Java Flight Recorder,Java 飞行记录器)记录 JVM 运行事件,线程 Dump 是某一时刻的线程堆栈快照。
原则是选择能够观察目标机制的最小层级。加载的组件和外部依赖越多,可触发失败的因素也越多。例如,扫描范围测试通常不需要启动 Web 服务;但客户端断连问题需要真实连接。性能分析还应明确测量起止点、环境、负载和重复次数,单次耗时或采样不能直接用于容量预测。
3. 验证 BeanDefinition,而不是先取 Bean
如果问题是“为什么没有注册”,先检查定义。下面是测试方法中的局部片段,需要项目提供 AppConfig,并引入 spring-context、AssertJ 及相应导入。假设配置中名为 paymentClient 的 Bean 被声明为懒加载,且刷新期间没有其他组件提前请求它:
java
try (var context = new AnnotationConfigApplicationContext()) {
context.register(AppConfig.class);
context.refresh();
assertThat(context.containsBeanDefinition("paymentClient")).isTrue();
var definition = context.getBeanFactory()
.getBeanDefinition("paymentClient");
assertThat(definition.isLazyInit()).isTrue();
}预期结果:定义存在,且其懒加载标记为 true。这两个断言检查的是创建元数据,并不证明对象已经创建成功。
refresh() 会创建非懒加载单例,因此仅仅不调用 getBean(),并不能保证目标对象尚未实例化。即使目标 Bean 标记为懒加载,也可能因其他 Bean 的依赖而提前创建。查询定义不会直接请求目标实例,但测试配置仍需控制刷新期间的依赖关系。
调用 getBean() 时,如果对象尚未创建,就可能进入实例化、依赖注入和初始化;如果已经创建,则可能直接取得已有对象。把它作为注册检查会混入对象创建阶段的失败,因而应先查询定义,再单独验证对象获取。
组件扫描和配置类解析见02 - 一个 @Component 如何变成 BeanDefinition。
4. 用 ApplicationContextRunner 验证自动配置
Starter 是集中提供依赖和自动配置入口的集成模块。测试自动配置时,需要同时检查条件满足后创建了什么,以及条件不满足时没有创建什么。下面是测试类中的局部片段,需要 JUnit Jupiter、AssertJ、Boot 测试工具及相关导入,并由项目提供 GreetingAutoConfiguration 和 GreetingClient:
java
private final ApplicationContextRunner runner = new ApplicationContextRunner()
.withConfiguration(AutoConfigurations.of(GreetingAutoConfiguration.class));
@Test
void createsClientWhenPropertyExists() {
runner.withPropertyValues("example.greeting.endpoint=https://example.test")
.run(context -> assertThat(context)
.hasSingleBean(GreetingClient.class));
}
@Test
void backsOffForUserBean() {
runner.withBean(GreetingClient.class,
() -> new GreetingClient("https://custom.test"))
.run(context -> assertThat(context)
.hasSingleBean(GreetingClient.class));
}预期结果:两个用例的上下文中都恰好有一个 GreetingClient。第一个用例检查提供地址属性后的创建结果;第二个用例检查提供用户 Bean 后的数量。这里的地址是配置输入,是否发出请求取决于项目中客户端的实现。
仅有数量断言还不足以完整证明退让:还应检查容器中的对象就是用户提供的对象,避免把其他同类型对象误认为用户 Bean。条件测试至少覆盖必要类存在/缺失、属性存在/缺失/非法、用户 Bean 退让、应用类型和自动配置顺序;每个用例只改变与目标条件相关的输入,才能看出结果由哪个条件决定。完整机制见17 - Spring Boot 自动配置与条件装配。
5. 验证生命周期要记录事件,不要依赖肉眼看日志
日志可能交错输出,也可能受异步写入影响,肉眼看到的顺序不适合作为稳定断言。可以让被测组件在实际回调中把事件追加到共享的线程安全列表。
下面是事件名称和记录方式的示意片段,需要 List、CopyOnWriteArrayList 的导入。各个 events.add(...) 应分别放入对应构造器或回调中;按下面的顺序直接执行这些语句,只能记录手工排列的顺序,不能验证 Spring 生命周期。postConstruct 表示 @PostConstruct 初始化回调,afterPropertiesSet 是 InitializingBean 的初始化方法,customInit 是配置的自定义初始化方法,最后一项表示 Bean 后处理器的初始化后回调:
java
List<String> events = new CopyOnWriteArrayList<>();
events.add("constructor");
events.add("postConstruct");
events.add("afterPropertiesSet");
events.add("customInit");
events.add("postProcessAfterInitialization");对于实际配置了上述回调的目标 Bean,上下文刷新后断言其事件的相对顺序,关闭上下文后再断言销毁事件。线程安全列表保证并发记录不破坏集合,不会让无关 Bean 之间形成固定的全局创建顺序。
异步启动应等待明确的完成信号,并设置超时;不要使用 sleep() 猜测启动何时结束,否则环境变慢时容易产生偶发失败。
若测试启动线程、消费者或调度器,应设置超时,并在 finally 或上下文关闭阶段验证资源确实停止。生命周期语义见05 - Bean 生命周期与扩展点顺序。
6. 代理验证分三步
先检查对象是否为 AOP(面向切面编程)代理,再检查预期 Advisor,最后通过方法调用观察增强效果。Advice 是增强的实际逻辑;Pointcut(切点)描述哪些类或方法应接受增强。
下面是前两步的局部片段,需要已初始化的 context、项目中的 PaymentService 和 ExpectedAdvice,以及 AssertJ、AopUtils、Advised 等导入。按类型获取 Bean 时,该类型必须与容器暴露的代理类型兼容:
java
Object bean = context.getBean(PaymentService.class);
assertThat(AopUtils.isAopProxy(bean)).isTrue();
if (bean instanceof Advised advised) {
assertThat(advised.getAdvisors())
.anyMatch(advisor -> advisor.getAdvice() instanceof ExpectedAdvice);
}预期结果:代理断言通过;当对象实现 Advised 时,Advisor 集合中至少有一项使用 ExpectedAdvice。Advised 是读取代理配置的接口,片段中的条件分支在对象未实现它时会跳过内部断言,因此不能把分支未执行当成 Advisor 检查通过。
第三步需要调用目标方法,并通过计数器、事务状态或缓存命中证明拦截器真正执行。不同检查之间不能相互替代:
text
代理存在
≠ 目标 Advisor 存在
≠ 当前方法匹配 Pointcut
≠ 调用经过代理应成对测试外部代理调用和同类 this 调用,相关原理见09 - Spring AOP 如何创建代理和10 - 同类调用为什么绕过 AOP。
7. 事务测试必须观察提交后的状态
在 Spring Test 管理测试事务的条件下,测试方法自身带 @Transactional 时,测试框架通常在用例结束后回滚。被测服务可能加入这个事务,因而服务方法返回并不代表物理事务已经提交;同一事务中的查询也不能证明提交后其他连接能看到结果。
REQUIRES_NEW 表示为内层调用开启独立事务,NESTED 在支持的事务管理器和资源条件下使用嵌套事务,通常涉及 Savepoint(保存点,即事务中可以局部回滚的位置)。rollback-only 是“该事务只能回滚”的状态标记。测试事务适合隔离数据,但会改变这些行为的观察边界,不能把用例最终回滚等同于每个被测方法都已正确回滚。
可靠验证方式包括:
- 让测试方法本身不处于事务中;
- 调用被测服务后,用新的事务或独立连接查询结果;
- 主动制造运行时异常、受检异常(checked exception,需要在 Java 方法签名中声明或捕获的异常)和提交阶段异常;
- 记录事务是否活动(active)、事务管理器、连接和最终数据库状态;
- 对
REQUIRES_NEW与NESTED使用生产同类数据库和驱动验证。
每种异常都应按实际回滚规则断言数据库结果,不能只断言抛出了异常。使用独立事务验证后,还需显式清理测试数据;不要假设测试方法的回滚能清理独立事务已经提交的写入。
H2 等内存数据库不能证明 MySQL 的锁范围、隔离级别、Savepoint 和错误码行为。事务链见11 - Spring 声明式事务执行链,传播测试矩阵见12 - 事务传播行为。
8. MVC 测试分清 Mock 与真实容器
下面是测试方法中的局部片段,需要 Spring Test、MediaType 的导入,以及 post、status、jsonPath 的静态导入,并配置好 mockMvc、订单 Controller 及 JSON 转换组件。Content-Type 声明请求体格式,Accept 声明客户端希望接收的响应格式:
java
mockMvc.perform(post("/orders")
.contentType(MediaType.APPLICATION_JSON)
.accept(MediaType.APPLICATION_JSON)
.content("""
{"productCode":"P-100","quantity":2}
"""))
.andExpect(status().isOk())
.andExpect(jsonPath("$.id").exists());预期结果:POST /orders 返回 200,JSON 响应中存在 id 字段。这不证明字段值正确或订单已经持久化;这类业务结果需要另设断言。
MockMvc 适合验证 HandlerMapping(请求与处理器的映射)、ArgumentResolver(将请求信息解析为方法参数)、ControllerAdvice(Controller 的共享增强,如异常处理)和 JSON 转换。它可以测试已加入其处理链的 Filter(请求、响应过滤器),但不能据此证明 Filter 在真实 Servlet 容器中的注册方式和顺序正确。
以下涉及部署或连接的行为需要真实 Servlet 容器或端到端环境:
- 端口与 Servlet 映射;
- 容器级 Filter 注册;
- 编码、压缩和流式响应;
- 客户端断连;
- 网关路径重写、超时和状态码改写。
不要把所有失败都塞进一个完整启动测试。先用最小 MVC 测试定位框架阶段,再用真实 HTTP 测试覆盖基础设施边界。
9. 源码调试的最小断点集
| 问题 | 建议入口 |
|---|---|
| 定义没有注册 | ConfigurationClassPostProcessor、ClassPathBeanDefinitionScanner |
| Bean 创建失败 | AbstractBeanFactory#doGetBean、AbstractAutowireCapableBeanFactory#doCreateBean |
| 注入候选错误 | DefaultListableBeanFactory#resolveDependency |
| 后处理器未执行 | initializeBean、applyBeanPostProcessorsBefore/AfterInitialization |
| 代理没有创建 | AbstractAutoProxyCreator#wrapIfNecessary |
| 事务没有进入 | TransactionInterceptor#invoke |
| MVC 没有匹配 | DispatcherServlet#doDispatch、RequestMappingHandlerMapping |
表中的入口用于定位阶段,具体方法和内部调用关系应按项目实际小版本源码查找;applyBeanPostProcessorsBefore/AfterInitialization 是两个初始化前后处理方法的合写。
先用失败断言固定问题,再在对应入口检查输入、条件分支和返回结果。例如,代理未创建时,关注目标 Bean 是否进入自动代理处理,以及匹配条件为何不成立。某次调试经过一个方法,只能说明当前用例走到了这里,不能替代成功与失败条件的成对测试。
条件断点应限制 Bean 名称、方法或请求路径,否则会频繁停在无关基础设施对象上。生产环境优先使用日志、指标、JFR 和受控诊断工具,不应直接附加高开销调试器。
10. 验证失败时如何分诊与保留证据
先确定第一个失败的层次,再保留能解释该层输入和结果的信息。Profile 是启用环境相关配置的一组名称;PropertySource 是配置属性的来源;Scope 是 Bean 的作用域,决定实例的复用范围。响应已 committed 表示响应已提交,后续修改状态码或响应头会受到限制。
- Spring、Boot、JDK、数据库和驱动版本;
- 测试使用的 Profile、PropertySource 和关键配置;
- BeanDefinition 来源、Bean 名称、Scope 和实际运行类型;
- Advisor、事务管理器、线程名及数据源;
- 请求方法、路径、Content-Type、Accept 和响应是否 committed;
- 随机种子、并发度、超时和外部依赖替身配置。
测试失败若只能输出“context failed to load”或“expected 200 but was 500”,仍不足以定位机制层次。上下文失败应结合完整异常原因链和 Bean 来源检查;响应失败应结合匹配到的处理器、参数解析及异常处理结果检查。不要把外层错误直接当成根因。
11. 容易踩的坑
完成用例后,可以用下面的问题检查证据是否足够:
- 是否为了验证单个条件加载了完整
@SpringBootTest上下文,增加了无关失败因素? - 是否 Mock(用测试替身替代)了事务管理器或数据库,却仍把结果解释为真实回滚证据?
- 是否只检查代理或 Advisor,没有观察目标方法的增强效果?
- 是否把测试事务的自动回滚当成服务的真实提交、回滚行为,或用 H2 推断 MySQL 的锁与隔离语义?
- 是否依赖日志顺序或固定等待时间,而没有明确的事件断言与超时?
- 是否关闭了上下文和执行器,避免污染后续测试或使进程无法退出?
12. 总结
Spring 机制测试的核心,是让每个断言只证明一个明确层次,并使用最小但足够真实的运行环境。
- 先区分定义、实例、代理、调用和外部结果。
- 自动配置用上下文切片,事务用真实资源,MVC 按 Mock 与真实容器分层。
- 测试既要覆盖成功路径,也要覆盖条件不满足、异常、回滚、关闭和响应失败。
阅读导航
- 容器全景:01 - 从 refresh() 读懂 Spring
- 自动配置测试:17 - Spring Boot 自动配置与条件装配
- 启动性能证据:19 - Spring 启动慢与 Bean 创建慢排查
- 线上证据链:20 - Spring 线上问题排查手册
- 并发测试方法:并发 A - Java 并发代码测试方法
- Advisor 顺序验证:24 - Spring 切面顺序与组合语义
- MVC 异步与断连验证:25 - Spring MVC 异步请求与流式响应
- Native Image 验证:26 - Spring AOT 与 Native Image
- 异步执行器验证:27 - Spring
@Async - 缓存命中与一致性验证:28 - Spring Cache
- 定时任务重叠与关闭验证:29 - Spring 定时任务