Spring Boot 单元测试实战：如何测试 RESTful 接口

单元测试实战：测试 RESTful 接口

在 Spring Boot 项目中，对 RESTful 接口进行单元测试是保障后端质量的关键环节。相比传统的 Mock 方式，直接使用集成测试可以更真实地模拟用户请求。

基础配置与依赖注入

测试类通常放在与被测 Controller 相同的包路径下，方便访问默认权限的成员。我们需要给测试类加上 @SpringBootTest 注解，并将 webEnvironment 设置为 RANDOM_PORT。这样做的好处是每次运行测试时，Spring 容器会启动一个全新的应用实例，且端口随机分配，避免了多任务并发时的端口冲突问题。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.client.TestRestTemplate;
import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class BookControllerTest {

    // 容器会自动注入 TestRestTemplate，用于发送 HTTP 请求
    @Autowired
    private TestRestTemplate testRestTemplate;

    // ... 后续代码
}

单次请求测试

拿到 TestRestTemplate 实例后，就可以像写业务代码一样调用接口了。以新增图书为例，我们构造一个 Book 对象，通过 postForObject 方法发送 POST 请求，并指定返回类型为 Book.class。

@Test
public void testAddBookRestful() {
    // 准备测试数据
    Book book = new Book("mysql", new BigDecimal(100), "ljh");
    
    // 发起 POST 请求，/books 是接口路径
       testRestTemplate.postForObject(, book, Book.class);
    
    
    assertEquals(, b.getName());
    assertEquals(BigDecimal.valueOf(), b.getPrice());
    assertEquals(, b.getAuthor());
}