Testes com Spring Boot

Esta habilidade oferece um guia especializado para testar aplicações Spring Boot 4 com padrões modernos e melhores práticas.

Princípios Fundamentais

1. Pirâmide de Testes: Unitário (rápido) > Camada (focado) > Integração (completo)
2. Ferramenta Certa: Use a menor camada que lhe dê confiança
3. Estilo AssertJ: Asserções fluídas e legíveis em vez de "matchers" verbosos
4. APIs Modernas: Prefira MockMvcTester e RestTestClient em vez de alternativas legadas

Qual Camada de Teste?

Referência de Camadas de Teste

• references/test-slices-overview.md - Matriz de decisão e comparação
• references/webmvctest.md - Camada Web com MockMvc
• references/datajpatest.md - Camada de Dados com Testcontainers
• references/restclienttest.md - Teste de cliente REST

Referência de Ferramentas de Teste

• references/mockmvc-tester.md - MockMvc no estilo AssertJ (3.2+)
• references/mockmvc-classic.md - MockMvc tradicional (pré-3.2)
• references/resttestclient.md - Cliente REST Spring Boot 4+
• references/mockitobean.md - Mocking de dependências

Bibliotecas de Asserção

• references/assertj-basics.md - Escalares, strings, booleanos, datas
• references/assertj-collections.md - Listas, Sets, Mapas, arrays

Testcontainers

• references/testcontainers-jdbc.md - PostgreSQL, MySQL, etc.

Geração de Dados de Teste

• references/instancio.md - Gera objetos de teste complexos (3+ propriedades)

Performance e Migração

• references/context-caching.md - Acelera suítes de testes
• references/sb4-migration.md - Mudanças do Spring Boot 4.0

Árvore de Decisão Rápida

Testing a controller endpoint?
  Yes → @WebMvcTest with MockMvcTester

Testing repository queries?
  Yes → @DataJpaTest with Testcontainers (real DB)

Testing business logic in service?
  Yes → Plain JUnit + Mockito (no Spring context)

Testing external API client?
  Yes → @RestClientTest with MockRestServiceServer

Testing JSON mapping?
  Yes → @JsonTest

Need full integration test?
  Yes → @SpringBootTest with minimal context config

Destaques do Spring Boot 4

• RestTestClient: Alternativa moderna ao TestRestTemplate
• @MockitoBean: Substitui @MockBean (depreciado)
• MockMvcTester: Asserções no estilo AssertJ para testes web
• Starters Modulares: Starters de teste específicos de tecnologia
• Pausamento de Contexto: Pausamento automático de contextos em cache (Spring Framework 7)

Melhores Práticas de Teste

Avaliação de Complexidade de Código

Quando um método ou classe é muito complexo para ser testado efetivamente:

1. Analise a complexidade - Se você precisar de mais de 5-7 casos de teste para cobrir um único método, ele provavelmente está muito complexo.
2. Recomende refatoração - Sugira dividir o código em funções menores e focadas.
3. Decisão do usuário - Se o usuário concordar em refatorar, ajude a identificar os pontos de extração.
4. Prossiga se necessário - Se o usuário decidir continuar com o código complexo, implemente os testes apesar da dificuldade.

Exemplo de recomendação de refatoração:

// Before: Complex method hard to test
public Order processOrder(OrderRequest request) {
  // Validation, discount calculation, payment, inventory, notification...
  // 50+ lines of mixed concerns
}

// After: Refactored into testable units
public Order processOrder(OrderRequest request) {
  validateOrder(request);
  var order = createOrder(request);
  applyDiscount(order);
  processPayment(order);
  updateInventory(order);
  sendNotification(order);
  return order;
}

Evite Redundância de Código

…