如何替换@SpringBootTest注解以仅装配单个类而非启动整个Spring Boot应用

Great question! When you don't want to spin up the entire Spring Boot application context just to test a single class, there are several targeted annotations and approaches you can use—depending on what type of component you're testing. Here's a breakdown of the most common options:

1. 纯单元测试（无需完整Spring上下文） #

如果不需要任何Spring专属特性（比如依赖注入），只想孤立测试类本身，完全可以跳过Spring注解，直接用JUnit 5的@Test：

import org.junit.jupiter.api.Test;

public class YourSingleClassTest {
    private final YourSingleClass yourInstance = new YourSingleClass();

    @Test
    void testYourMethod() {
        // 这里写测试逻辑，不需要Spring参与
    }
}

如果确实需要基础的Spring支持（比如依赖注入）但不想加载完整上下文，就用@ExtendWith(SpringExtension.class)搭配@ContextConfiguration，只加载必要的类：

import org.springframework.test.context.junit.jupiter.SpringExtension;
import org.springframework.test.context.ContextConfiguration;
import org.junit.jupiter.api.extension.ExtendWith;
import org.springframework.beans.factory.annotation.Autowired;

@ExtendWith(SpringExtension.class)
@ContextConfiguration(classes = {YourSingleClass.class})
public class YourSingleClassTest {
    @Autowired
    private YourSingleClass yourInstance;

    @Test
    void testYourMethod() {
        // 用Spring管理的实例做测试
    }
}

2. 分层专属测试注解 #

Spring Boot提供了专门的注解，只会加载对应应用层相关的组件，让测试更快、更聚焦：

测试Web控制器：@WebMvcTest #

这个注解只加载Spring MVC相关组件（控制器、处理器映射、异常处理器等），不会加载服务层或数据访问层的Bean。搭配MockMvc测试端点行为非常合适：

import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.web.servlet.MockMvc;
import org.junit.jupiter.api.Test;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    void testYourEndpoint() throws Exception {
        mockMvc.perform(get("/your-endpoint"))
               .andExpect(status().isOk());
    }
}

测试JPA仓库：@DataJpaTest #

它只会初始化JPA相关组件，自动配置内存数据库，完全聚焦于数据访问层的测试：

import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.junit.jupiter.api.Test;

@DataJpaTest
public class YourRepositoryTest {
    @Autowired
    private YourRepository yourRepository;

    @Test
    void testSaveEntity() {
        // 测试仓库的CRUD操作
        YourEntity entity = new YourEntity();
        yourRepository.save(entity);
        
        assert yourRepository.findById(entity.getId()).isPresent();
    }
}

测试服务层（Spring Boot 3.1+）：@ServiceTest #

新版本Spring Boot新增了@ServiceTest，专门聚焦服务层Bean，会自动Mock它的依赖（比如仓库）：

import org.springframework.boot.test.autoconfigure.service.ServiceTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.junit.jupiter.api.Test;

import static org.mockito.Mockito.when;
import static org.junit.jupiter.api.Assertions.assertNotNull;

@ServiceTest
public class YourServiceTest {
    @Autowired
    private YourService yourService;

    @MockBean
    private YourRepository yourRepository; // 自动被Mock

    @Test
    void testServiceMethod() {
        // 设置Mock行为
        when(yourRepository.findById(1L)).thenReturn(java.util.Optional.of(new YourEntity()));
        
        // 测试服务逻辑
        var result = yourService.getEntity(1L);
        assertNotNull(result);
    }
}

如果是旧版Spring Boot，可以用@ExtendWith(SpringExtension.class) + @ContextConfiguration搭配@MockBean手动Mock依赖（参考第1节的示例）。

3. 最小化Spring Boot上下文 #

如果还是需要Spring Boot上下文，但只想限定到目标类，可以给@SpringBootTest加上classes参数，指定要加载的Bean：

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

@SpringBootTest(classes = {YourSingleClass.class})
public class YourSingleClassTest {
    @Autowired
    private YourSingleClass yourInstance;

    @Test
    void testYourMethod() {
        // 用最小化的Spring Boot上下文做测试
    }
}

这比默认的@SpringBootTest（加载应用所有Bean）要轻量，但还是会初始化完整的Spring Boot环境。

内容的提问来源于stack exchange，提问作者Programmer