Claude Code: Supercharge Spring Boot Tests with Testcontainers

As a Java developer building Spring Boot applications, you’ve likely faced the frustration of integration tests that are flaky, slow, or rely on complex setup instructions for external services. Manually starting up a PostgreSQL instance for testing database queries, or a Kafka broker for event-driven components, can be a significant drag on your development workflow. This is where Testcontainers shines, providing ephemeral, real instances of databases, message brokers, and other services directly within your test environment, managed by Docker.

Integrating Testcontainers with Spring Boot’s testing infrastructure, especially when using JUnit 5, is remarkably straightforward. You can leverage @SpringBootTest in conjunction with Testcontainers’ JUnit 5 extension to automatically start and stop your containerized dependencies before and after your tests run. This means your tests interact with a genuine database or message queue, offering much higher confidence than mocks or in-memory alternatives, without the manual overhead.

Claude Code, the powerful AI assistant for developers, can further streamline this process by helping you generate the necessary boilerplate code and configurations for your Testcontainers setup. Imagine asking Claude Code to generate a PostgreSQLContainer definition, complete with JDBC URL and username/password, tailored for your Spring Boot application. This saves valuable time and reduces the chance of misconfiguration, allowing you to focus on writing the actual test logic that verifies your application’s behavior against these real dependencies.

Here’s a concise example showing how you might set up a PostgreSQL container for a Spring Boot test using JUnit 5 and Testcontainers. Claude Code can help you generate similar setups for other services like Kafka, Redis, or Elasticsearch.

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.jdbc.core.JdbcTemplate;
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;
import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
@Testcontainers
class UserRepositoryIntegrationTest {

    @Container
    static PostgreSQLContainer<?> postgresqlContainer = new PostgreSQLContainer<>("postgres:15.3")
            .withDatabaseName("testdb")
            .withUsername("testuser")
            .withPassword("testpassword");

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Test
    void testDatabaseConnection() {
        String dbName = jdbcTemplate.queryForObject("SELECT current_database()", String.class);
        assertThat(dbName).isEqualTo("testdb");
    }
}

Try it: Ask Claude Code to generate a KafkaContainer setup for your Spring Boot application.