@SpringBootTest是Spring Boot集成测试核心注解，启动完整应用上下文以验证组件协作、配置加载、外部依赖及AOP/事务等真实行为；区别于@WebMvcTest等切片测试，它更重但更贴近生产环境。
@SpringBootTest 是 Spring Boot 提供的用于集成测试的核心注解，它能启动完整的 Spring 应用上下文（类似启动一个精简版应用），适合验证组件间协作、配置加载、自动装配、数据库连接等真实运行环境下的行为。和 @WebMvcTest 或 @DataJpaTest 这类切片测试不同，它默认加载整个应用上下文，因此更重，但更贴近实际运行状态。
什么时候该用 @SpringBootTest
当你需要验证以下场景时，@SpringBootTest 是合适选择：
- 多个 Bean 协同工作（如 Service 调用 Repository，再触发 Event）
- 自定义配置属性（
@ConfigurationProperties）是否正确绑定 - 外部依赖（如 Redis、DataSource、RabbitMQ）是否成功初始化并可注入
- 切面（AOP）、事务（
@Transactional）、安全性（Spring Security）等横切逻辑生效情况
基础用法：默认加载全部配置
最简写法如下，不加任何参数时会尝试查找主配置类（含 @SpringBootApplication 的类）并加载完整上下文：
@SpringBootTest
class UserServiceIntegrationTest {
@Autowired
private UserService userService;
@Test
void shouldFindUserById() {
User user = userService.findById(1L);
assertThat(user).isNotNull();
}
}
注意：测试类需放在能被主配置类扫描到的包路径下（或显式指定 classes），否则可能找不到 Bean。
控制上下文加载范围
为提升测试速度或隔离关注点，可通过参数缩小上下文范围：
-
只加载特定配置类：
@SpringBootTest(classes = {TestConfig.class, UserService.class})—— 忽略主启动类，仅加载列出的类 -
指定配置文件：
@SpringBootTest(properties = "spring.profiles.active=test")或搭配@ActiveProfiles("test")切换 profile -
禁用 Web 环境（纯非 Web 场景）：
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)—— 避免启动嵌入式服务器，加快启动 -
模拟 Web 环境（无需真实端口）：
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.MOCK)—— 可配合@AutoConfigureMockMvc做 API 层测试
常见问题与建议
使用过程中容易遇到几个典型问题：
-
启动太慢：确认是否真需要全量上下文；优先考虑切片测试（如
@DataJpaTest测 DAO，@WebMvcTest测 Controller） -
Bean 冲突或找不到：检查包扫描路径、
@ComponentScan范围，或改用classes显式声明所需配置 -
数据库污染：搭配
@Transactional（方法级或类级）让每个测试自动回滚；或使用 H2 内存库 +@Sql初始化数据 -
外部服务干扰：用
@MockBean替换真实客户端（如 RestTemplate、FeignClient），避免调用真实第三方接口
不复杂但容易忽略：确保测试类在 src/test/java 下，且依赖已引入 spring-boot-starter-test（它包含 JUnit、Mockito、Spring Test 等支持）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
