Formations — 1 037 leçons en français

Accueil › Spring Boot › Testcontainers : tester avec une vraie base

Testcontainers : tester avec une vraie base

Tests avancésintermediaire

@DataJpaTest avec H2 est rapide, mais H2 n'est pas PostgreSQL (ni MySQL) : certains comportements SQL diffèrent (types spécifiques, fonctions, contraintes). Testcontainers résout ce problème en démarrant une vraie base dans un conteneur Docker, le temps du test.

@Testcontainers
@SpringBootTest
class ProduitRepositoryIT {

    @Container
    @ServiceConnection
    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16");

    @Autowired
    private ProduitRepository repository;

    @Test
    void save_persiste_le_produit() {
        Produit produit = repository.save(new Produit("Clavier", 49.90));
        assertThat(produit.getId()).isNotNull();
    }
}

@Testcontainers gère le cycle de vie du conteneur ; @Container sur un champ statique le démarre une seule fois pour toute la classe. @ServiceConnection (Spring Boot 3.1+) configure automatiquement le DataSource de l'application avec les informations de connexion du conteneur — sans elle, il faudrait les enregistrer manuellement avec @DynamicPropertySource.

Deux prérequis : Docker doit être disponible sur la machine qui exécute les tests, et le démarrage d'un conteneur prend quelques secondes — un coût à limiter en partageant un conteneur entre plusieurs tests plutôt qu'en le redémarrant à chaque fois.

Les termes à connaître

Testcontainers

Bibliothèque Java qui démarre de vrais services (base de données, message broker…) dans des conteneurs Docker jetables, le temps des tests, puis les détruit automatiquement. Le test s'exécute contre le même moteur qu'en production, pas contre un substitut.

Pourquoi pas H2 ?

H2 imite le dialecte SQL de PostgreSQL ou MySQL, mais imparfaitement : types spécifiques (JSONB, UUID natif…), fonctions SQL, contraintes, comportement de verrouillage ou de tri peuvent différer. Un test qui passe sous H2 peut échouer en production sous le vrai SGBD.

@Testcontainers

Extension JUnit 5 (org.testcontainers.junit.jupiter.Testcontainers) qui gère automatiquement le cycle de vie des champs annotés @Container : démarrage avant les tests, arrêt après.

@Container

Marque un champ conteneur géré par l'extension. Sur un champ statique, le conteneur démarre une seule fois pour toute la classe de test (partagé entre les méthodes) ; sur un champ d'instance, un nouveau conteneur démarre à chaque méthode — nettement plus lent, rarement utile.

PostgreSQLContainer

Conteneur prêt à l'emploi (module org.testcontainers:postgresql) qui démarre une instance PostgreSQL réelle : new PostgreSQLContainer<>("postgres:16"). Il existe des équivalents pour MySQL, MongoDB, Kafka, RabbitMQ…

@ServiceConnection

Depuis Spring Boot 3.1, annotation posée sur le champ @Container qui configure automatiquement les propriétés de connexion Spring Boot (URL JDBC, identifiants…) à partir du conteneur démarré. Plus besoin de déclarer ces propriétés à la main.

@DynamicPropertySource

Méthode statique qui enregistre des propriétés Spring calculées à l'exécution (ex. container::getJdbcUrl), car le port du conteneur n'est connu qu'une fois démarré. Approche antérieure à @ServiceConnection, toujours utile pour les services non couverts par elle.

Conteneur partagé entre classes

Pattern qui évite de redémarrer un conteneur (coûteux, plusieurs secondes) pour chaque classe de test : une classe de base abstraite démarre un conteneur statique une seule fois pour tout le processus de test, réutilisé par toutes les classes qui en héritent.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.