SpringBoot集成JUnit单元测试实战指南

@SpringBootTest 注解

@SpringBootTest 注解的核心作用是告知测试框架：当前测试类是一个 Spring Boot 集成测试类，需要加载完整的应用上下文，包括所有配置、组件和依赖关系。简而言之，它会模拟一次完整的应用启动过程，为集成测试提供所需的上下文环境。

该注解包含三个核心属性，值得开发者重点关注：

• classes：用于指定需要加载的配置类。默认情况下，Spring Boot 会在当前测试类所在包及其子包中查找带有 @SpringBootApplication 注解的主配置类。若默认配置不符合需求，或应用启动逻辑较为特殊（例如 main 方法中进行了自定义处理），则需手动指定 classes 属性，这实际上相当于执行 SpringApplication.run(xxx.class, args)。如果启动逻辑过于复杂，建议放弃使用 @SpringBootTest，直接在测试中手动调用启动类的 main 方法。
• webEnvironment：用于定义 Web 环境类型，默认值为 WebEnvironment.MOCK，即模拟 Web 环境，无需实际启动服务器。
• properties：允许向应用上下文中添加额外属性，用于覆盖配置文件中的已有配置项。

采用 @SpringBootTest 编写集成测试，能够真实验证整个应用中各组件、依赖关系及配置之间的协同工作，比单纯的单元测试更贴近生产环境，有效提升测试可靠性。

集成 JUnit 5

JUnit 5 是 JUnit 系列最新的主流版本，相较于前代版本进行了大量改进，更契合现代 Java 开发的需求。其架构主要分为三个组成部分：

引入 JUnit 5

自 Spring Boot 2.2.0 版本起，JUnit 5 已成为默认的单元测试库。因此，只要项目中 Spring Boot 版本不低于 2.2.0，在 pom.xml 中添加 spring-boot-starter-test 依赖，即可直接使用 JUnit 5 进行测试：

    org.springframework.boot
    spring-boot-starter-test
    test

使用 JUnit 5

以下是一个简洁的代码示例：

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest(classes = xxx.class)
public class MyTest {
    
    @Test
    void myTest(){
        // ...
    }
    
}

JUnit 5 常用测试注解

下表汇总了 JUnit 5 中最常用的注解，推荐收藏备查：

集成 JUnit 4

尽管 JUnit 5 已成为主流，但许多老旧项目仍在使用 JUnit 4，因此有必要详细介绍集成方法。

引入 JUnit 4

方式一

Spring Boot 2.4 及以上版本默认移除了 Vintage 引擎依赖，如果仍需使用 JUnit 4 的注解（如 @Test），则需要手动添加 junit-vintage-engine 依赖：

    org.junit.vintage
    junit-vintage-engine
    test
    
        
            org.hamcrest
            hamcrest-core
        
    

方式二

另一种更为直接的方式：直接引入 JUnit 4 框架：

    junit
    junit
    test

使用 JUnit 4

JUnit 4 测试类的写法如下，特别需要注意添加 @RunWith(SpringJUnit4ClassRunner.class) 和 @ContextConfiguration 注解：

import org.junit.runner.RunWith;
import org.springframework.test.context.ContextConfiguration;
import org.junit.Test;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = {"classpath:applicationContext.xml"})
public class LocalTest {
    @Test
    void test(){
        // ...
    }
}

总结

本文全面介绍了 Spring Boot 集成 JUnit 单元测试的关键知识点，包括 @SpringBootTest 注解的使用方法、JUnit 5 与 JUnit 4 的引入及实际运用，基本涵盖了日常开发中的常见场景。在实际项目中选择哪个版本，应根据项目具体情况决定，核心在于掌握各版本对应的注解和配置方式。