我最近在为一个 Spring Boot 项目编写服务模块时，遇到了一些单元测试的坑。很多新手在写 Spring Boot 项目时，只知道业务代码该怎么写，但不知道如何系统地编写测试代码来验证逻辑。
这篇文章主要面向 Spring Boot 初学者与 Java 后端开发者，带你从零开始搭建测试环境、编写测试类，并通过代码示例展示测试方法的正确用法。
一、为什么要写单元测试？
在企业项目中，单元测试是代码质量保障的第一道防线。
它的意义在于：
- 验证你的业务逻辑是否符合预期；
- 避免功能修改时引入新的 Bug；
- 提高系统的可维护性和稳定性；
- 支持持续集成（CI/CD）中的自动测试流程。
简单来说，单元测试写得好，项目就不会"动一下就出问题" 。
二、Spring Boot 测试环境准备
在 Spring Boot 项目中，Spring 官方已经提供了完善的测试支持框架。
你只需要在 pom.xml 中引入以下依赖即可（通常会默认存在）：
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 目录下：
bash
src
├── main
│ └── java/com/example/demo/service/MyService.java
└── test
└── java/com/example/demo/service/MyServiceTest.java
AI写代码
12345建议测试类命名规则：
被测试类名 + Test
例如：
UserService→UserServiceTest
四、编写第一个单元测试
下面是一个最基础的 Spring Boot 测试类示例：
java
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 项目中，**单元测试不仅是验证功能的工具，更是保障项目质量的基石** 。 我在实际开发中体会到：只要测试写得规范，后期维护时几乎不用担心逻辑出错。