编辑“︁Spring Boot测试”︁（章节）

= Spring Boot测试 =

Spring Boot测试是Spring框架中用于验证应用程序行为的关键部分，它提供了丰富的工具和注解来简化单元测试、集成测试和端到端测试的编写。通过Spring Boot的测试支持，开发者可以确保应用程序的各个组件（如控制器、服务、存储库等）按预期工作。

== 概述 ==
Spring Boot测试基于JUnit（通常是JUnit 5）和Spring TestContext框架，并提供了以下核心功能：
* '''自动配置'''：通过<code>@SpringBootTest</code>加载完整的应用程序上下文或部分配置。
* '''Mock支持'''：通过<code>@MockBean</code>模拟依赖项。
* '''测试切片'''（Test Slices）：仅加载特定层（如Web层、数据层）的配置。
* '''嵌入式服务器测试'''：使用<code>@AutoConfigureMockMvc</code>或<code>@WebMvcTest</code>测试Web层。

== 测试类型 ==
=== 1. 单元测试 ===
单元测试验证单个组件（如服务类）的逻辑，通常不加载Spring上下文。

<syntaxhighlight lang="java">
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class CalculatorServiceTest {
    @Test
    public void testAdd() {
        CalculatorService service = new CalculatorService();
        assertEquals(5, service.add(2, 3));
    }
}
</syntaxhighlight>

=== 2. 集成测试 ===
集成测试验证多个组件的交互，需要加载Spring上下文。

<syntaxhighlight lang="java">
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

@SpringBootTest
public class UserServiceIntegrationTest {
    @Autowired
    private UserService userService;

    @Test
    public void testCreateUser() {
        User user = userService.createUser("testUser");
        assertNotNull(user.getId());
    }
}
</syntaxhighlight>

=== 3. Web层测试 ===
使用<code>@WebMvcTest</code>仅加载Web层组件，并搭配<code>MockMvc</code>模拟HTTP请求。

<syntaxhighlight lang="java">
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

@WebMvcTest(UserController.class)
public class UserControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testGetUser() throws Exception {
        mockMvc.perform(get("/users/1"))
               .andExpect(status().isOk())
               .andExpect(jsonPath("$.name").value("Alice"));
    }
}
</syntaxhighlight>

== 关键注解 ==
以下是Spring Boot测试中常用的注解：

<mermaid>
pie
    title 常用测试注解占比
    "@SpringBootTest" : 35
    "@WebMvcTest" : 25
    "@DataJpaTest" : 20
    "@MockBean" : 15
    "@AutoConfigureMockMvc" : 5
</mermaid>

* <code>@SpringBootTest</code>：加载完整应用程序上下文。
* <code>@WebMvcTest</code>：仅加载Web MVC组件。
* <code>@DataJpaTest</code>：仅配置JPA和嵌入式数据库。
* <code>@MockBean</code>：向Spring上下文添加Mock对象。

== 实际案例 ==
假设我们有一个任务管理系统，需要测试任务创建和分配功能：

<syntaxhighlight lang="java">
@SpringBootTest
public class TaskSystemTest {
    @Autowired
    private TaskService taskService;

    @MockBean
    private NotificationService notificationService;

    @Test
    public void testTaskAssignment() {
        Task task = taskService.createTask("Fix bug", "HIGH");
        taskService.assignTask(task.getId(), "developer@example.com");

        verify(notificationService).sendAssignmentEmail("developer@example.com");
    }
}
</syntaxhighlight>

== 测试配置 ==
Spring Boot允许通过<code>application-test.properties</code>覆盖测试环境的配置：
<syntaxhighlight lang="properties">
# src/test/resources/application-test.properties
spring.datasource.url=jdbc:h2:mem:testdb
spring.jpa.hibernate.ddl-auto=create-drop
</syntaxhighlight>

== 高级主题 ==
=== 测试事务 ===
默认情况下，测试方法会在事务中执行并在结束后回滚：
<syntaxhighlight lang="java">
@SpringBootTest
@Transactional
public class TransactionalTest {
    @Test
    public void testRollback() {
        // 数据库操作会被回滚
    }
}
</syntaxhighlight>

=== 测试覆盖率 ===
结合JaCoCo等工具计算测试覆盖率：
<syntaxhighlight lang="xml">
<!-- Maven配置示例 -->
<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.7</version>
    <executions>
        <execution>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
        </execution>
    </executions>
</plugin>
</syntaxhighlight>

== 最佳实践 ==
* 优先使用测试切片（如<code>@WebMvcTest</code>）减少上下文加载时间。
* 为Mock对象定义明确的行为，避免过度模拟。
* 将测试分类为单元测试、集成测试和端到端测试。
* 使用<code>@TestConfiguration</code>提供特定的测试配置。

通过掌握Spring Boot测试，开发者可以构建健壮的应用程序并确保代码质量。测试不仅是验证工具，更是设计辅助手段，能帮助发现组件间的耦合问题。

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring Boot]]