Spring Boot 单元测试 0基础教程

咱们以一种通俗易懂的方式，通过一个简单的实例来教你怎么在Spring Boot项目中进行单元测试。

假设你有一个简单的Spring Boot应用，里面有一个UserService接口，以及它的实现类 UserServiceImpl，这个服务有一个方法用来获取用户的问候语。

// UserService.java
public interface UserService {
    String sayHelloTo(String name);
}

// UserServiceImpl.java
@Service
public class UserServiceImpl implements UserService {

    @Override
    public String sayHelloTo(String name) {
        return "Hello, " + name + "!";
    }
}

为了对该方法进行单元测试，我们可以创建一个对应的测试类。首先，确保你的项目包含了Spring Boot Test的依赖项，通常在build.gradle或pom.xml里添加如下依赖：

// Maven构建脚本（pom.xml）
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

然后，创建一个名为UserServiceTest的测试类：

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

@SpringBootTest(classes = YourApplication.class)
public class UserServiceTest {

    @Autowired
    private UserService userService; // 被测试的真实服务对象注入

    @MockBean
    private UserService mockUserService; // 创建模拟的服务对象，用于某些特定场景

    @Test
    public void testSayHelloTo() {
        // 对真实服务对象的测试
        String result = userService.sayHelloTo("Spring Boot");
        assertEquals("Hello, Spring Boot!", result);

        // 对模拟服务对象的测试（可选，用于模拟复杂依赖场景）
        Mockito.when(mockUserService.sayHelloTo(Mockito.anyString())).thenReturn("Hi there!");

        String mockedResult = mockUserService.sayHelloTo("Unit Tester");
        assertEquals("Hi there!", mockedResult);
    }
}

@SpringBootTest注解告诉Spring Boot要启动一个微型应用上下文来进行测试，其中包含你的主类YourApplication。

• @Autowired注解用于将真实的UserService实例注入到测试类中，这样可以直接测试真实的服务实现。

• @MockBean则创建了一个模拟的UserService对象，当我们的服务有很多依赖项，而又不想真正调用那些依赖时，可以使用模拟对象替代。

• @Test注解标记了一个测试方法，这里我们测试了sayHelloTo方法，使用assertEquals方法来验证实际结果是否与预期相符。

通过这个基础的例子，你应该对外如何在Spring Boot应用中编写单元测试有了初步的认识。实际工作中，单元测试还会涉及到数据库操作、REST API接口调用等各种更复杂的场景，但基本原则都是：为被测试代码设置合理的输入，调用方法，然后验证输出是否符合预期。

你学废了吗？