Как работает аннотация @SpringBootTest?

Аннотация @SpringBootTest — это ключевой инструмент для интеграционного тестирования в Spring Boot приложениях. В отличие от модульных тестов, которые проверяют отдельные компоненты изолированно, интеграционные тесты проверяют, как несколько компонентов работают вместе в рамках поднятого Spring контекста. Это позволяет убедиться в корректности внедрения зависимостей, конфигурации бинов и работы с базой данных в тестовой среде.

Основные возможности

• Загрузка контекста: По умолчанию аннотация ищет класс, помеченный @SpringBootConfiguration (обычно это основной класс приложения), и загружает полный контекст на его основе.
• Настройка конфигурации: С помощью атрибутов можно указать конкретные классы конфигурации (classes), профили (properties или @ActiveProfiles) или даже не загружать контекст (webEnvironment).
• Web-окружение: Атрибут webEnvironment позволяет выбрать тип окружения: от полного запуска встроенного сервера (WebEnvironment.RANDOM_PORT) до тестирования без web-слоя (WebEnvironment.NONE).

Практический пример

Рассмотрим простой тест для сервиса, который работает с репозиторием. Аннотация @SpringBootTest поднимет контекст, и мы сможем протестировать инжектнутые бины.

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
public class UserServiceIntegrationTest {

    @Autowired
    private UserService userService;

    @Test
    public void testGetUserById() {
        User user = userService.getUserById(1L);
        assertThat(user).isNotNull();
        assertThat(user.getName()).isEqualTo("John Doe");
    }
}

Где и как применяется

Аннотация применяется для тестирования сложных сценариев, где необходимо проверить взаимодействие слоёв приложения: сервисов с репозиториями, работу контроллеров через MockMvc или TestRestTemplate, корректность конфигурации Spring Security, транзакций и т.д. Она особенно полезна при использовании тестовой базы данных (например, с @DataJpaTest и @AutoConfigureTestDatabase).

Вывод: Используйте @SpringBootTest для написания интеграционных тестов, когда нужно проверить совместную работу нескольких компонентов Spring в условиях, максимально приближённых к реальному запуску приложения. Для изолированных модульных тестов отдельных бинов предпочтительнее использовать @ExtendWith(MockitoExtension.class) и моки.