在 spring boot 单元测试中引入测试框架,核心是添加 spring-boot-starter-test 依赖并配合 @springboottest 注解。该 starter 默认集成了 junit 5、mockito 和 assertj,开发者只需在测试类上标注 @springboottest 即可自动加载应用上下文。若需隔离数据库或外部服务,可结合 @mockbean 替换特定 bean,从而快速构建可复现的测试环境。

如何配置最小化的集成测试类
要创建一个能启动 Spring 容器的基础测试类,必须使用 @SpringBootTest 注解。该注解会触发 ApplicationContext 的初始化,使得所有被 @Component 或 @Service 标记的 Bean 均可通过 @Autowired 注入。对于不需要完整容器启动的场景,应改用 @WebMvcTest 仅加载 Web 层组件,以加快测试速度。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class ApplicationIntegrationTest {
@Autowired
private MyService myService;
@Test
void contextLoads() {
// 验证 Bean 是否成功注入
assert myService != null;
}
}
上述代码展示了最简结构:类级别标注 @SpringBootTest,字段级标注 @Autowired。运行该测试时,Spring Boot 会扫描主配置类所在的包路径,加载所有符合条件的 Bean。若项目中存在多个配置文件(如 application.yml),测试会自动读取 src/test/resources 下的同名文件。若需指定特定配置,可在 @SpringBootTest 中使用 properties 属性覆盖默认值。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何模拟外部依赖进行单元测试
当需要测试业务逻辑而不依赖真实数据库或 HTTP 服务时,应使用 @MockBean。该注解会在 Spring 容器中创建指定类型的 Mock 对象,并自动替换原有 Bean。结合 Mockito 的 when(...).thenReturn(...) 语法,可以精确控制模拟行为的返回值,确保测试只关注当前类的逻辑正确性。

import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.bean.MockBean;
@SpringBootTest
class ServiceUnitTest {
@MockBean
private ExternalClient externalClient;
@Autowired
private MyService myService;
@Test
void testWithMockedDependency() {
Mockito.when(externalClient.fetchData()).thenReturn("mocked_data");
String result = myService.process();
assert "processed_mocked_data".equals(result);
}
}
在此示例中,@MockBean 确保了 ExternalClient 不会发起真实网络请求。MyService 内部调用 fetchData() 时,将直接返回预设字符串。这种模式适用于测试复杂业务流程中的分支判断,例如处理空值、异常或特定状态码。注意 @MockBean 仅在使用 @SpringBootTest 时有效,纯 JUnit 测试需使用 @ExtendWith(MockitoExtension.class) 配合 @Mock。
当 MockBean 替换失败时会发生什么
如果尝试用 @MockBean 替换一个不存在的 Bean 类型,Spring Boot 会抛出 IllegalArgumentException。这是因为 @MockBean 依赖于容器中已存在的 Bean 定义,若类型未注册,则无法完成替换操作。此时测试将无法启动,控制台会显示明确的错误信息提示缺少目标 Bean。

















