Testcontainers: Integrationstests med en rigtig database
Start PostgreSQL i Docker med Testcontainers, og kør integrationstests mod en rigtig database.
Testcontainers: Integrationstests med en rigtig database er en gratis Java Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i Java Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Java Academy-kurset indeholder 4 lektioner i alt.
Hvorfor Testcontainers?
Hukommelsesdatabaser som H2 understøtter ikke PostgreSQL-specifikke funktioner som JSON, fuldtekstsøgning og ON CONFLICT. Testcontainers starter rigtige Docker-containere under tests, så du får en database, der svarer til produktionen.
Tilføjelse af Testcontainers-afhængighed
Tilføj Testcontainers BOM'en og PostgreSQL-modulet til din buildfil. Spring Boot 3.1+ inkluderer en versionsstyret Testcontainers-version.
// build.gradle:
testImplementation "org.testcontainers:junit-jupiter"
testImplementation "org.testcontainers:postgresql"
// Optionally use Spring Boot Testcontainers support:
testImplementation "org.springframework.boot:spring-boot-testcontainers"@Testcontainers og @Container
Annotér testklassen med @Testcontainers, og deklarér containeren som et statisk felt med @Container. JUnit 5 starter og stopper den automatisk.
@Testcontainers
@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
class UserRepositoryIntegrationTest {
@Container
static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine")
.withDatabaseName("testdb")
.withUsername("test")
.withPassword("test");
}Konfiguration af DataSource fra en container
Brug @DynamicPropertySource til at indsætte containerens dynamiske port og legitimationsoplysninger i Spring's DataSource-konfiguration.
@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
registry.add("spring.datasource.url", postgres::getJdbcUrl);
registry.add("spring.datasource.username", postgres::getUsername);
registry.add("spring.datasource.password", postgres::getPassword);
}Spring Boot 3.1 ServiceConnection
Spring Boot 3.1+ konfigurerer automatisk DataSource ud fra en Testcontainers-@Container-bean, der er annoteret med @ServiceConnection — du behøver ikke @DynamicPropertySource.
@Bean
@ServiceConnection
static PostgreSQLContainer<?> postgresContainer() {
return new PostgreSQLContainer<>("postgres:16-alpine");
}Singleton-container-mønster
Det er langsomt at starte en container for hver testklasse. Del én container mellem alle tests ved hjælp af et statisk felt med Startables.deepStart() eller en abstrakt basisklasse.
abstract class AbstractIntegrationTest {
@Container
static final PostgreSQLContainer<?> POSTGRES =
new PostgreSQLContainer<>("postgres:16-alpine").withReuse(true);
static { POSTGRES.start(); }
@DynamicPropertySource
static void props(DynamicPropertyRegistry r) {
r.add("spring.datasource.url", POSTGRES::getJdbcUrl);
r.add("spring.datasource.username", POSTGRES::getUsername);
r.add("spring.datasource.password", POSTGRES::getPassword);
}
}Test af PostgreSQL-specifikke funktioner
Med Testcontainers kan du teste JSON-kolonner, JSONB-operatorer, fuldtekstsøgning og ON CONFLICT DO UPDATE — hvilket er umuligt med H2.
@Test
void jsonb_search_works() {
// Insert row with JSONB column, then query
List<Event> logins = repo.findByType("login");
assertEquals(1, logins.size());
}Flere containere: Compose
Brug DockerComposeContainer til at køre en hel stak (Postgres + Redis + Kafka) til integrationstests, der kræver flere tjenester.
@Container
static DockerComposeContainer<?> compose = new DockerComposeContainer<>(
new File("src/test/resources/docker-compose.yml"))
.withExposedService("postgres", 5432)
.withExposedService("redis", 6379);Ryuk: Automatisk oprydning
Testcontainers bruger en Ryuk-container til automatisk at stoppe og fjerne containere, når JVM'en afsluttes — også hvis en test mislykkes, så du undgår containerlækager.
@SpringBootTest med Testcontainers
Brug @SpringBootTest i stedet for @DataJpaTest til at teste hele applikationsstakken (controllere, tjenester, repositories) mod en ægte Postgres-container.
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@Testcontainers
class FullIntegrationTest extends AbstractIntegrationTest {
@LocalServerPort int port;
@Autowired TestRestTemplate rest;
@Test
void end_to_end_user_creation() {
ResponseEntity<UserDto> r = rest.postForEntity("/api/users", createReq(), UserDto.class);
assertEquals(HttpStatus.CREATED, r.getStatusCode());
}
}Caching af containerimages
Testcontainers cacher lokalt de Docker-images, der er hentet. Hent images i CI, før testene kører (docker pull postgres:16-alpine), så du undgår downloadomkostninger under testkørslen.
Hurtigt tjek
Hvilken annotation forbinder automatisk en Testcontainers-container med Springs DataSource i Spring Boot 3.1+?
Opsummering
Testcontainers kører ægte Docker-containere til integrationstests. Brug @Container + @DynamicPropertySource eller @ServiceConnection (Boot 3.1+). Del containere mellem tests med singleton-mønsteret. Test PostgreSQL-specifikke funktioner, som er umulige med H2.
Lær Java med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 104
- Lektioner
- 374
Ofte stillede spørgsmål
Er lektionen “Testcontainers: Integrationstests med en rigtig database” gratis?
Ja — hele teksten til “Testcontainers: Integrationstests med en rigtig database” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af Java Academy-kurset, skal du opgradere til CoddyKit PRO. Java Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Testcontainers: Integrationstests med en rigtig database”?
Start PostgreSQL i Docker med Testcontainers, og kør integrationstests mod en rigtig database. Du øver dig i Java Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på Java Academy?
Der kræves ingen tidligere erfaring. Java Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.
Hvor lang tid tager lektionen “Testcontainers: Integrationstests med en rigtig database”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne Java Academy-lektion?
Ja. Alle Java Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Parameteriserede tests med @CsvSource og @MethodSource
- Avanceret Mockito: ArgumentCaptors og spies
- Spring Boot-test slices: @WebMvcTest og @DataJpaTest
- Testcontainers: Integrationstests med en rigtig database