springboot-verification

Spring Boot Verifikationsschleife

Vor PRs, nach größeren Änderungen und vor dem Deployment ausführen.

Wann zu aktivieren

• Vor dem Öffnen eines Pull-Requests für einen Spring Boot Service
• Nach größeren Refactorings oder Abhängigkeits-Upgrades
• Pre-Deployment Verifikation für Staging oder Produktion
• Ausführen der vollständigen Build → Lint → Test → Security Scan Pipeline
• Validierung der Testabdeckung gegen Schwellenwerte

Phase 1: Build

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

Falls der Build fehlschlägt, anhalten und beheben.

Phase 2: Statische Analyse

Maven (gängige Plugins):

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

Gradle (falls konfiguriert):

./gradlew checkstyleMain pmdMain spotbugsMain

Phase 3: Tests + Coverage

mvn -T 4 test
mvn jacoco:report   # 80%+ Abdeckung prüfen
# oder
./gradlew test jacocoTestReport

Bericht:

• Gesamttests, bestanden/fehlgeschlagen
• Abdeckung % (Zeilen/Zweige)

Unit-Tests

Service-Logik isoliert mit gemockten Abhängigkeiten testen:

@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);
  }
}

Integrationstests mit Testcontainers

Gegen eine echte Datenbank statt H2 testen:

@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");
  }
}

API-Tests mit MockMvc

Controller-Ebene mit vollständigem Spring-Kontext testen:

@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());
  }
}

Phase 4: Sicherheitsscan

# Abhängigkeits-CVEs
mvn org.owasp:dependency-check-maven:check
# oder
./gradlew dependencyCheckAnalyze

# Secrets im Quellcode
grep -rn "password\s*=\s*\"" src/ --include="*.java" --include="*.yml" --include="*.properties"
grep -rn "sk-\|api_key\|secret" src/ --include="*.java" --include="*.yml"

# Secrets (Git-Historie)
git secrets --scan  # falls konfiguriert

Häufige Sicherheitsbefunde

# Prüfen auf System.out.println (Logger verwenden)
grep -rn "System\.out\.print" src/main/ --include="*.java"

# Prüfen auf rohe Exception-Nachrichten in Antworten
grep -rn "e\.getMessage()" src/main/ --include="*.java"

# Prüfen auf Wildcard-CORS
grep -rn "allowedOrigins.*\*" src/main/ --include="*.java"

Phase 5: Lint/Format (optionales Gate)

mvn spotless:apply   # falls Spotless-Plugin verwendet wird
./gradlew spotlessApply

Phase 6: Diff-Review

git diff --stat
git diff

Checkliste:

• Keine Debug-Logs hinterlassen (System.out, log.debug ohne Guards)
• Aussagekräftige Fehler und HTTP-Statuscodes
• Transaktionen und Validierungen vorhanden, wo nötig
• Konfigurationsänderungen dokumentiert

Ausgabevorlage

VERIFIKATIONSBERICHT
====================
Build:     [PASS/FAIL]
Statisch:  [PASS/FAIL] (spotbugs/pmd/checkstyle)
Tests:     [PASS/FAIL] (X/Y bestanden, Z% Abdeckung)
Sicherheit:[PASS/FAIL] (CVE-Funde: N)
Diff:      [X Dateien geändert]

Insgesamt: [BEREIT / NICHT BEREIT]

Zu behebende Probleme:
1. ...
2. ...

Kontinuierlicher Modus

• Phasen bei signifikanten Änderungen oder alle 30–60 Minuten in langen Sitzungen erneut ausführen
• Kurze Schleife beibehalten: mvn -T 4 test + spotbugs für schnelles Feedback

Denken Sie daran: Schnelles Feedback ist besser als späte Überraschungen. Halten Sie das Gate streng – behandeln Sie Warnungen in Produktionssystemen als Fehler.