Formations — 1 037 leçons en français

Accueil › Spring Boot › Tests d'intégration avec @SpringBootTest

Tests d'intégration avec @SpringBootTest

Tester son applicationdebutant

@SpringBootTest démarre toute l'application, comme au vrai lancement : tous les beans sont créés et assemblés. Contrairement à un test unitaire (leçon précédente), on vérifie que les différentes couches fonctionnent ensemble.

@SpringBootTest
@ActiveProfiles("test")
class CommandeServiceIT {

    @Autowired
    private CommandeService service;

    @MockitoBean
    private NotificationService notificationService; // remplacé par un mock

    @Test
    void confirmerCommande_change_le_statut() {
        Commande resultat = service.confirmer(1L);

        assertThat(resultat.getStatut()).isEqualTo("CONFIRMEE");
        verify(notificationService).envoyer(anyString());
    }
}

Par défaut, webEnvironment = WebEnvironment.MOCK : pas de vrai serveur HTTP. Avec RANDOM_PORT, un serveur démarre réellement sur un port libre, utilisable avec TestRestTemplate. @MockitoBean remplace un bean gênant (un vrai envoi d'e-mail, un appel à une API externe) par un mock, le temps du test.

Ces tests sont plus lents qu'un test unitaire : Spring doit charger le contexte complet. Spring essaie de le réutiliser entre les classes de test qui ont la même configuration, mais chaque configuration différente en force un nouveau.

Les termes à connaître

@SpringBootTest

Démarre le vrai contexte Spring pour le test : tous les beans de l'application sont créés, comme au lancement réel. Contrairement aux tests unitaires, on vérifie que les pièces s'assemblent correctement. Plus lent qu'un test unitaire, car tout le contexte est chargé.

webEnvironment

Attribut de @SpringBootTest qui choisit comment le serveur web est simulé. MOCK (par défaut) : pas de vrai serveur, un contexte web simulé. RANDOM_PORT : un vrai serveur démarre sur un port libre, utile avec TestRestTemplate ou WebTestClient. DEFINED_PORT et NONE existent aussi, plus rares.

@AutoConfigureMockMvc

Ajoute un bean MockMvc au contexte du test, pour simuler des requêtes HTTP sans serveur réel (utilisable avec webEnvironment = MOCK, la valeur par défaut).

TestRestTemplate

Client HTTP fourni par Spring Boot pour appeler l'application via de vraies requêtes réseau, quand webEnvironment = RANDOM_PORT. Utile pour un test bout-en-bout proche de la réalité.

@MockitoBean

Remplace un bean du contexte Spring par un mock Mockito, le temps du test (package org.springframework.test.context.bean.override.mockito). Introduite avec Spring Framework 6.2 / Spring Boot 3.4. Elle remplace @MockBean, dépréciée mais encore très répandue dans les projets existants — même principe, ancien package (org.springframework.boot.test.mock.mockito).

@ActiveProfiles

Active un ou plusieurs profils Spring pour le test, par exemple @ActiveProfiles("test"). Permet de charger une configuration différente (application-test.yml), typiquement une base H2 en mémoire à la place de la vraie base.

@Transactional (sur un test)

Sur une méthode ou une classe de test, ouvre une transaction avant chaque test et la annule (rollback) à la fin, qu'il réussisse ou échoue. Les données insérées pendant le test ne polluent pas les tests suivants.

Cache du contexte Spring

Spring réutilise un contexte déjà démarré entre plusieurs classes de test si leur configuration est strictement identique (mêmes annotations, mêmes profils, mêmes beans remplacés). Un contexte différent (ex. un @MockitoBean différent) force un redémarrage complet, ce qui ralentit la suite de tests.

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.