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,UUIDnatif…), 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
@Containerqui 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.
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.