springboot-verification

Ciclo de Verificação Spring Boot

Execute antes de PRs, após mudanças importantes e pré-deploy.

Quando Ativar

• Antes de abrir um pull request para um serviço Spring Boot
• Após grandes refatorações ou upgrades de dependências
• Verificação pré-deploy para staging ou produção
• Executar pipeline completo: build → lint → teste → varredura de segurança
• Validar se a cobertura de testes atende aos thresholds

Fase 1: Build

mvn -T 4 clean verify -DskipTests
# ou
./gradlew clean assemble -x test

Se o build falhar, pare e corrija.

Fase 2: Análise Estática

Maven (plugins comuns):

mvn -T 4 spotbugs:check pmd:check checkstyle:check

Gradle (se configurado):

./gradlew checkstyleMain pmdMain spotbugsMain

Fase 3: Testes + Cobertura

mvn -T 4 test
mvn jacoco:report   # verificar 80%+ de cobertura
# ou
./gradlew test jacocoTestReport

Relatório:

• Total de testes, aprovados/reprovados
• % de cobertura (linhas/ramos)

Testes Unitários

Testar a lógica do serviço isoladamente com dependências simuladas:

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

  @Mock private UserRepository userRepository;
  @InjectMocks private UserService userService;

  @Test
  void createUser_validInput_returnsUser() {
    var dto = new CreateUserDto("Alice", "[email protected]");
    var expected = new User(1L, "Alice", "[email protected]");
    when(userRepository.save(any(User.class))).thenReturn(expected);

    var result = userService.create(dto);

    assertThat(result.name()).isEqualTo("Alice");
    verify(userRepository).save(any(User.class));
  }

  @Test
  void createUser_duplicateEmail_throwsException() {
    var dto = new CreateUserDto("Alice", "[email protected]");
    when(userRepository.existsByEmail(dto.email())).thenReturn(true);

    assertThatThrownBy(() -> userService.create(dto))
        .isInstanceOf(DuplicateEmailException.class);
  }
}

Testes de Integração com Testcontainers

Testar contra um banco de dados real em vez de H2:

@SpringBootTest
@Testcontainers
class UserRepositoryIntegrationTest {

  @Container
  static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine")
      .withDatabaseName("testdb");

  @DynamicPropertySource
  static void configureProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.datasource.url", postgres::getJdbcUrl);
    registry.add("spring.datasource.username", postgres::getUsername);
    registry.add("spring.datasource.password", postgres::getPassword);
  }

  @Autowired private UserRepository userRepository;

  @Test
  void findByEmail_existingUser_returnsUser() {
    userRepository.save(new User("Alice", "[email protected]"));

    var found = userRepository.findByEmail("[email protected]");

    assertThat(found).isPresent();
    assertThat(found.get().getName()).isEqualTo("Alice");
  }
}

Testes de API com MockMvc

Testar a camada de controle com contexto Spring completo:

@WebMvcTest(UserController.class)
class UserControllerTest {

  @Autowired private MockMvc mockMvc;
  @MockBean private UserService userService;

  @Test
  void createUser_validInput_returns201() throws Exception {
    var user = new UserDto(1L, "Alice", "[email protected]");
    when(userService.create(any())).thenReturn(user);

    mockMvc.perform(post("/api/users")
            .contentType(MediaType.APPLICATION_JSON)
            .content("""
                {"name": "Alice", "email": "[email protected]"}
                """))
        .andExpect(status().isCreated())
        .andExpect(jsonPath("$.name").value("Alice"));
  }

  @Test
  void createUser_invalidEmail_returns400() throws Exception {
    mockMvc.perform(post("/api/users")
            .contentType(MediaType.APPLICATION_JSON)
            .content("""
                {"name": "Alice", "email": "not-an-email"}
                """))
        .andExpect(status().isBadRequest());
  }
}

Fase 4: Varredura de Segurança

# CVEs de dependências
mvn org.owasp:dependency-check-maven:check
# ou
./gradlew dependencyCheckAnalyze

# Segredos no código-fonte
grep -rn "password\s*=\s*\"" src/ --include="*.java" --include="*.yml" --include="*.properties"
grep -rn "sk-\|api_key\|secret" src/ --include="*.java" --include="*.yml"

# Segredos (histórico do git)
git secrets --scan  # se configurado

Achados Comuns de Segurança

# Verificar por System.out.println (usar logger no lugar)
grep -rn "System\.out\.print" src/main/ --include="*.java"

# Verificar por mensagens de exceção brutas nas respostas
grep -rn "e\.getMessage()" src/main/ --include="*.java"

# Verificar por CORS com curinga
grep -rn "allowedOrigins.*\*" src/main/ --include="*.java"

Fase 5: Lint/Formatação (portão opcional)

mvn spotless:apply   # se usando plugin Spotless
./gradlew spotlessApply

Fase 6: Revisão de Diff

git diff --stat
git diff

Checklist:

• Nenhum log de depuração deixado (System.out, log.debug sem proteções)
• Erros e status HTTP significativos
• Transações e validação presentes onde necessário
• Mudanças de configuração documentadas

Template de Saída

RELATÓRIO DE VERIFICAÇÃO
=========================
Build:     [APROVADO/REPROVADO]
Estático:  [APROVADO/REPROVADO] (spotbugs/pmd/checkstyle)
Testes:    [APROVADO/REPROVADO] (X/Y aprovados, Z% cobertura)
Segurança: [APROVADO/REPROVADO] (Achados CVE: N)
Diff:      [X arquivos alterados]

Geral:     [PRONTO / NÃO PRONTO]

Problemas a Corrigir:
1. ...
2. ...

Modo Contínuo

• Re-executar fases em mudanças significativas ou a cada 30–60 minutos em sessões longas
• Manter um loop curto: mvn -T 4 test + spotbugs para feedback rápido

Lembre-se: Feedback rápido é melhor que surpresas tardias. Mantenha o portão rigoroso—trate avisos como defeitos em sistemas de produção.