【Spring Boot 单元测试教程】从环境搭建到代码验证的完整实践

我最近在为一个 Spring Boot 项目编写服务模块时，遇到了一些单元测试的坑。很多新手在写 Spring Boot 项目时，只知道业务代码该怎么写，但不知道如何系统地编写测试代码来验证逻辑。

这篇文章主要面向 Spring Boot 初学者与 Java 后端开发者，带你从零开始搭建测试环境、编写测试类，并通过代码示例展示测试方法的正确用法。

---

一、为什么要写单元测试？

在企业项目中，单元测试是代码质量保障的第一道防线。

它的意义在于：

• 验证你的业务逻辑是否符合预期；
• 避免功能修改时引入新的 Bug；
• 提高系统的可维护性和稳定性；
• 支持持续集成（CI/CD）中的自动测试流程。

简单来说，单元测试写得好，项目就不会"动一下就出问题" 。

---

二、Spring Boot 测试环境准备

在 Spring Boot 项目中，Spring 官方已经提供了完善的测试支持框架。

你只需要在 pom.xml 中引入以下依赖即可（通常会默认存在）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

AI写代码xml
12345

这个依赖包含了：

• JUnit 5：核心测试框架；
• Mockito：Mock 模拟框架；
• Spring Test：加载应用上下文，支持 Bean 注入。

---

三、项目结构与测试类命名规范

Spring Boot 默认遵循 Maven 项目结构，测试类应放在 src/test/java 目录下：

src
├── main
│   └── java/com/example/demo/service/MyService.java
└── test
    └── java/com/example/demo/service/MyServiceTest.java

AI写代码
12345

建议测试类命名规则：

被测试类名 + Test

例如：UserService → UserServiceTest

---

四、编写第一个单元测试

下面是一个最基础的 Spring Boot 测试类示例：

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.beans.factory.annotation.Autowired;

@SpringBootTest
public class MyServiceTest {

    @Autowired
    private MyService myService;

    @Test
    public void testProcessData() {
        String result = myService.processData("Hello");
        assert result.equals("Processed: Hello");
    }
}

AI写代码java
运行
12345678910111213141516

✅ 代码解析：

• @SpringBootTest：表示该测试类会加载完整的 Spring 容器。
• @Autowired：将被测对象注入测试类。
• @Test：JUnit 测试方法注解，表示该方法是一个测试用例。
• assert：断言语句，验证预期结果与实际结果是否一致。

---

五、进阶：使用 MockBean 模拟依赖

在测试中我们常常不希望真实访问[数据库]或第三方接口，这时可以使用 @MockBean 注解来"伪造"依赖 Bean。

示例代码\])如下： ```java import org.junit.jupiter.api.Test; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.boot.test.mock.mockito.MockBean; import org.springframework.beans.factory.annotation.Autowired; import static org.mockito.Mockito.*; @SpringBootTest public class UserServiceTest { @MockBean private UserRepository userRepository; @Autowired private UserService userService; @Test public void testFindUser() { when(userRepository.findByName("Alice")) .thenReturn(new User("Alice", 25)); User result = userService.findByName("Alice"); assert result.getAge() == 25; } } AI写代码java 运行 1234567891011121314151617181920212223242526 ``` #### [](https://link.juejin.cn?target= "")[](https://link.juejin.cn?target= "")✅ Mock 测试要点： * `@MockBean`：让 Spring 自动生成一个模拟对象； * `when(...).thenReturn(...)`：定义该 Mock 对象的行为； * 这种方式能确保测试只聚焦于业务逻辑本身，不受外部依赖干扰。 *** ** * ** *** ### [](https://link.juejin.cn?target= "")[](https://link.juejin.cn?target= "")六、运行测试的两种方式 1. **IDE 运行** * 在 IntelliJ IDEA 中，右键单击测试类 → `Run MyServiceTest`； * 控制台中出现绿色的 "✔ PASSED" 表示测试通过。 2. **命令行运行** ```bash mvn test AI写代码bash 1 ``` Maven 会自动扫描 `src/test/java` 下的所有测试类并执行。 *** ** * ** *** ### [](https://link.juejin.cn?target= "")[](https://link.juejin.cn?target= "")七、常见问题与解决方案 | 问题 | 原因分析 | 解决方法 | |---------------|-------------------------------------|---------------------------------| | Spring 容器加载失败 | 测试类不在主启动类的包层级下 | 确保测试类与主应用类在同一包或其子包中 | | Bean 注入失败 | 缺少 `@SpringBootTest` 或 `@Autowired` | 检查注解是否正确 | | 测试未执行 | `@Test` 导包错误（JUnit4/5 混用） | 使用 `org.junit.jupiter.api.Test` | *** ** * ** *** ### [](https://link.juejin.cn?target= "")[](https://link.juejin.cn?target= "")八、写测试的好习惯 1. 每个业务方法都写对应的测试方法； 2. 使用有意义的测试方法名，例如 `testCalculatePrice_WhenDiscountApplied()`； 3. 测试结果要有断言（`assert` 或 `Assertions.assertEquals()`）； 4. 保持测试独立，不依赖运行顺序； 5. 测试数据可通过 Mock 或内存数据模拟。 *** ** * ** *** ### [](https://link.juejin.cn?target= "")[](https://link.juejin.cn?target= "")九、结语 在 Spring Boot 项目中，**单元测试不仅是验证功能的工具，更是保障项目质量的基石** 。 我在实际开发中体会到：只要测试写得规范，后期维护时几乎不用担心逻辑出错。