Testcontainers
Тема дорожной карты · Java
Testcontainers — это библиотека Java с открытым исходным кодом, предоставляющая одноразовые, Docker-обеспеченные экземпляры баз данных, брокеров сообщений, поисковых движков и любых других сервисов с образами контейнеров, обеспечивая настоящие интеграционные тесты, выполняемые против реальных зависимостей, а не моков или встроенных заменителей. Testcontainers напрямую интегрируется с JUnit 5 через аннотации @Testcontainers и @Container, автоматически управляя жизненным циклом контейнера — запуск перед тестами, остановка после — и предоставляя маппированные порты через методы вроде container.getMappedPort(5432) для построения JDBC URL во время теста. Распространённые модули Testcontainers включают PostgreSQLContainer, MySQLContainer, MongoDBContainer, KafkaContainer, RedisContainer и LocalStackContainer — все предоставляют предварительно сконфигурированные контейнеры, воспроизводящие производственные зависимости без какой-либо инфраструктурной настройки за пределами работающего Docker-демона. Testcontainers мощно сочетается со Spring Boot Test: @SpringBootTest в комбинации с @DynamicPropertySource вводит свойства подключения контейнера в Spring ApplicationContext, позволяя интеграционным тестам Hibernate, JDBC и JPA выполняться против реальной базы данных в той же JUnit 5 тест-сюите, что и модульные тесты с Mockito и AssertJ. Используя Testcontainers, Java-команды разработчиков устраняют проблему «работает у меня» для интеграционных тестов, повышают надёжность CI-конвейера и обретают уверенность в том, что Spring, Hibernate и JDBC-код корректно работает с реальными SQL-движками и брокерами сообщений.
Как это работает
Testcontainers использует JUnit 5 как де факто unit-test framework (@Test, @ParameterizedTest, @BeforeEach), AssertJ или Hamcrest для fluent-ассертов, Mockito для моков, Testcontainers для подъёма реальных БД/сервисов в Docker для integration-тестов, REST Assured для HTTP API-тестов. Spring Boot имеет свои test-slice (@WebMvcTest, @DataJpaTest), загружающие минимальный контекст.
Когда применять
JUnit 5 + AssertJ — дефолтный стек. Testcontainers — для любого кода, касающегося реальной БД; мок БД прячет реальные баги (constraint violations, ошибки запроса). Mockito — осторожно; over-mocking тестирует мок, не код. Тесты в CI на каждый PR; валите билды на flake.
Типичные ошибки
Ловушки Testcontainers: тесты, делящие state через static-поля; мокинг всего, пока тест — это просто verify(...)-вызовы; медленные Spring Boot integration-тесты, потому что каждый тест поднимает весь контекст (используйте slice-тесты); flaky-тесты оставлены — каждый подрывает доверие.