Springboot Verification

作者 affaan-mef648e01899b無授權條款275K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫3 天前更新

Bucle de verificación para proyectos Spring Boot: build, análisis estático, pruebas con cobertura, escaneos de seguridad y revisión de diff antes del lanzamiento o PR.

僅含說明Software Development Security

AI 產生的概覽

為 Spring Boot 專案執行驗證迴圈：建置、靜態分析、含涵蓋率的測試、安全掃描與差異審查。

功能: 為 Spring Boot 專案提供分階段的 PR 前與部署前驗證迴圈，涵蓋建置、靜態分析、含涵蓋率的測試、安全掃描與差異審查。它提供具體的 Maven 與 Gradle 指令，以及單元測試、Testcontainers 整合測試與 MockMvc API 測試的 Java 範例。最後附上輸出報告範本與重複執行迴圈的建議。
適用情境: 適用於為 Spring Boot 服務送出拉取請求之前、重大重構或相依套件升級之後，或面向預備環境與正式環境的部署前驗證。也適合用來確認測試涵蓋率是否達到門檻。
執行需求: 需要以 Maven 或 Gradle 建置的 Spring Boot 專案，以及選用的 SpotBugs、PMD、Checkstyle、JaCoCo、Spotless、OWASP dependency-check 與 git-secrets 等外掛。Testcontainers 範例需要 Docker。不附指令碼，僅為說明文件。

Bucle de Verificación Spring Boot

Ejecutar antes de PRs, después de cambios importantes y antes del despliegue.

Cuándo Activar

Antes de abrir un pull request para un servicio Spring Boot
Después de refactorizaciones importantes o actualizaciones de dependencias
Verificación previa al despliegue para staging o producción
Ejecutar el pipeline completo de build → lint → test → escaneo de seguridad
Validar que la cobertura de pruebas cumpla los umbrales

Fase 1: Build

Si el build falla, detener y corregir.

Fase 2: Análisis Estático

Maven (plugins comunes):

Gradle (si está configurado):

Fase 3: Pruebas + Cobertura

Reporte:

Total de pruebas, pasadas/fallidas
% de cobertura (líneas/ramas)

Pruebas Unitarias

Probar la lógica del servicio en aislamiento con dependencias mockeadas:

java

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

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

Pruebas de Integración con Testcontainers

Probar contra una base de datos real en lugar de H2:

java

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

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

Pruebas de API con MockMvc

Probar la capa controller con el contexto completo de Spring:

java

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

@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: Escaneo de Seguridad

bash

# CVEs de dependenciasmvn org.owasp:dependency-check-maven:check# o./gradlew dependencyCheckAnalyze
# Secretos en código fuentegrep -rn "password\s*=\s*\"" src/ --include="*.java" --include="*.yml" --include="*.properties"grep -rn "sk-\|api_key\|secret" src/ --include="*.java" --include="*.yml"
# Secretos (historial de git)git secrets --scan  # si está configurado

# CVEs de dependenciasmvn org.owasp:dependency-check-maven:check# o./gradlew dependencyCheckAnalyze
# Secretos en código fuentegrep -rn "password\s*=\s*\"" src/ --include="*.java" --include="*.yml" --include="*.properties"grep -rn "sk-\|api_key\|secret" src/ --include="*.java" --include="*.yml"
# Secretos (historial de git)git secrets --scan  # si está configurado

Hallazgos Comunes de Seguridad

bash

# Verificar System.out.println (usar logger en su lugar)grep -rn "System\.out\.print" src/main/ --include="*.java"
# Verificar mensajes de excepción en bruto en respuestasgrep -rn "e\.getMessage()" src/main/ --include="*.java"
# Verificar CORS comodíngrep -rn "allowedOrigins.*\*" src/main/ --include="*.java"

# Verificar System.out.println (usar logger en su lugar)grep -rn "System\.out\.print" src/main/ --include="*.java"
# Verificar mensajes de excepción en bruto en respuestasgrep -rn "e\.getMessage()" src/main/ --include="*.java"
# Verificar CORS comodíngrep -rn "allowedOrigins.*\*" src/main/ --include="*.java"

Fase 5: Lint/Formato (compuerta opcional)

Fase 6: Revisión de Diff

Lista de verificación:

Sin logs de depuración residuales (System.out, log.debug sin guardias)
Errores y códigos HTTP con significado
Transacciones y validación presentes donde se necesitan
Cambios de configuración documentados

Plantilla de Salida

REPORTE DE VERIFICACIÓN=======================Build:      [PASS/FAIL]Estático:   [PASS/FAIL] (spotbugs/pmd/checkstyle)Pruebas:    [PASS/FAIL] (X/Y pasadas, Z% cobertura)Seguridad:  [PASS/FAIL] (hallazgos CVE: N)Diff:       [X archivos modificados]
General:    [LISTO / NO LISTO]
Problemas a Corregir:1. ...2. ...

REPORTE DE VERIFICACIÓN=======================Build:      [PASS/FAIL]Estático:   [PASS/FAIL] (spotbugs/pmd/checkstyle)Pruebas:    [PASS/FAIL] (X/Y pasadas, Z% cobertura)Seguridad:  [PASS/FAIL] (hallazgos CVE: N)Diff:       [X archivos modificados]
General:    [LISTO / NO LISTO]
Problemas a Corregir:1. ...2. ...

Modo Continuo

Volver a ejecutar las fases ante cambios significativos o cada 30–60 minutos en sesiones largas
Mantener un bucle corto: mvn -T 4 test + spotbugs para retroalimentación rápida

Recuerda: La retroalimentación rápida supera las sorpresas tardías. Mantener la compuerta estricta — tratar las advertencias como defectos en sistemas de producción.

來源與署名

來源：affaan-m/ecc位於docs/es/skills/springboot-verification提交ef648e0

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Springboot Verification

Bucle de Verificación Spring Boot

Cuándo Activar

Fase 1: Build

Fase 2: Análisis Estático

Fase 3: Pruebas + Cobertura

Pruebas Unitarias

Pruebas de Integración con Testcontainers

Pruebas de API con MockMvc

Fase 4: Escaneo de Seguridad

Hallazgos Comunes de Seguridad

Fase 5: Lint/Formato (compuerta opcional)

Fase 6: Revisión de Diff

Plantilla de Salida

Modo Continuo

來源與署名

更多來自 affaan-m/ecc 的技能

Vue Patterns

Uncloud

Team Agent Orchestration

Tasteforge Video

Taste

Social Publisher

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices