English

Pruebas por capas, no un arranque completo

Deja de arrancar toda tu aplicación para una sola prueba de controlador. En Spring, un @SpringBootTest completo conecta todas las capas — web, servicios, datos, configuración — lo cual es exactamente correcto para comportamiento entre capas y exactamente incorrecto como hábito por defecto. Spring Boot incluye slice tests (pruebas por capas) diseñados para cargar solo la capa bajo prueba, y la diferencia se acumula en cada clase de prueba y cada corrida de CI.

Qué carga realmente un slice test

Cada anotación de slice @…Test hace dos cosas: restringe el escaneo de componentes a los beans relevantes de esa capa, e importa solo un conjunto reducido de auto-configuraciones en lugar de todas.

• @WebMvcTest carga únicamente la capa MVC: @Controller, @ControllerAdvice, converters, filtros, interceptores y beans WebMvcConfigurer. Los beans @Component y @ConfigurationProperties comunes no se escanean. Auto-configura MockMvc (y MockMvcTester cuando AssertJ está en el classpath), así que pruebas el manejo de requests sin un servidor corriendo. Los colaboradores se sustituyen con @MockitoBean.
• @DataJpaTest carga entidades y repositorios de Spring Data JPA, los apunta a una base de datos embebida de prueba, te da un TestEntityManager y hace rollback de la transacción al final de cada prueba por defecto.
• La misma familia cubre otras capas: @JsonTest para serialización, @JdbcTest para SQL directo, @RestClientTest para clientes HTTP salientes, @WebFluxTest para controladores reactivos, @DataMongoTest para Mongo. El mapeo completo de anotación a auto-configuración está en el apéndice de Spring Boot (ver Recursos).

Reglas prácticas

Una restricción que conviene conocer: no puedes combinar varias anotaciones de slice @…Test en una misma clase. Elige el slice que corresponde a la capa y agrega extras con la anotación @AutoConfigure… correspondiente si hace falta.

Un slice de controlador en la práctica

@WebMvcTest(UserVehicleController.class)
class UserVehicleControllerTests {

    @Autowired
    private MockMvc mvc;

    @MockitoBean
    private UserVehicleService userVehicleService;

    @Test
    void returnsVehicleDetails() throws Exception {
        given(userVehicleService.getVehicleDetails("sboot"))
                .willReturn(new VehicleDetails("Honda", "Civic"));
        mvc.perform(get("/sboot/vehicle"))
                .andExpect(status().isOk())
                .andExpect(content().string("Honda Civic"));
    }
}

Sin datasource, sin capa de servicios, sin contexto completo — solo la capa web y un stub.

Por qué importa para programar con IA

Un asistente de IA aprende los hábitos de tu código con el ejemplo. Si cada prueba existente es un @SpringBootTest de arranque completo, el asistente tomará la herramienta más pesada para cada prueba nueva que escriba — y tu ciclo de feedback se degrada un archivo generado a la vez. Siembra el repositorio con slice tests y declara la convención explícitamente en las instrucciones del proyecto: "las pruebas de controladores usan @WebMvcTest, las de repositorios usan @DataJpaTest, @SpringBootTest se reserva para comportamiento entre capas." Las pruebas generadas seguirán entonces el camino rápido por defecto.

Nivel avanzado: aprovecha el caché de contextos

El framework de pruebas de Spring cachea contextos de aplicación entre pruebas — un contexto se construye una vez por configuración única y se reutiliza, con un límite por defecto de 32 contextos (desalojo LRU; se ajusta con -Dspring.test.context.cache.maxSize). Dos hábitos maximizan los aciertos:

• Mantén las configuraciones idénticas. Cada @MockitoBean, perfil o propiedad modificada crea un contexto nuevo. Estandariza tus configuraciones de slice para que decenas de clases de prueba compartan un solo contexto cacheado.
• Observa el caché en CI. Pon org.springframework.test.context.cache en nivel DEBUG para ver cuántos contextos distintos construye realmente tu suite. Una suite que construye 20 contextos te está diciendo que tus configuraciones de prueba se desviaron.

Recursos

• Testing Spring Boot applications — referencia oficial
• Anotaciones de test slice y sus auto-configuraciones — apéndice
• @WebMvcTest — javadoc de la API
• @DataJpaTest — javadoc de la API
• Caché de contextos — Spring TestContext framework

Read this article in English