Springboot Tdd

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

Desarrollo guiado por pruebas para Spring Boot usando JUnit 5, Mockito, MockMvc, Testcontainers y JaCoCo. Usar al agregar funcionalidades, corregir bugs o refactorizar.

僅含說明Software Development

AI 產生的概覽

指導 Spring Boot 服務的測試驅動開發，使用 JUnit 5、Mockito、MockMvc、Testcontainers 與 JaCoCo。

功能: 為 Spring Boot 專案提供 TDD 工作流程：先撰寫會失敗的測試，再實作最小程式碼，接著重構，並以 JaCoCo 強制覆蓋率。它提供單元測試、使用 MockMvc 的 Web 層測試、使用 SpringBootTest 的整合測試，以及使用 DataJpaTest 與 Testcontainers 的持久化測試範例。內容也涵蓋 AssertJ 斷言、測試資料建構器，以及 Maven、Gradle 的 CI 指令。
適用情境: 適用於新增功能或端點、修正錯誤或重構 Spring Boot 服務時。也適合在加入資料存取邏輯或安全規則，並希望測試先行的情況使用。
執行需求: 僅為說明文件，未附帶指令碼。假定已有 Spring Boot 專案，並包含 JUnit 5、Mockito、MockMvc、Testcontainers、JaCoCo、AssertJ 以及 Maven 或 Gradle 等建置工具。Testcontainers 需要容器執行環境，CI 指令需要網路存取以下載相依套件。

Flujo de Trabajo TDD en Spring Boot

Orientación TDD para servicios Spring Boot con 80%+ de cobertura (unit + integración).

Cuándo Usar

Nuevas funcionalidades o endpoints
Correcciones de bugs o refactorizaciones
Agregar lógica de acceso a datos o reglas de seguridad

Flujo de Trabajo

Escribir pruebas primero (deben fallar)
Implementar el código mínimo para que pasen
Refactorizar con pruebas en verde
Exigir cobertura con JaCoCo

Pruebas Unitarias (JUnit 5 + Mockito)

java

@ExtendWith(MockitoExtension.class)class MarketServiceTest {  @Mock MarketRepository repo;  @InjectMocks MarketService service;
  @Test  void createsMarket() {    CreateMarketRequest req = new CreateMarketRequest("name", "desc", Instant.now(), List.of("cat"));    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));
    Market result = service.create(req);
    assertThat(result.name()).isEqualTo("name");    verify(repo).save(any());  }}

@ExtendWith(MockitoExtension.class)class MarketServiceTest {  @Mock MarketRepository repo;  @InjectMocks MarketService service;
  @Test  void createsMarket() {    CreateMarketRequest req = new CreateMarketRequest("name", "desc", Instant.now(), List.of("cat"));    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));
    Market result = service.create(req);
    assertThat(result.name()).isEqualTo("name");    verify(repo).save(any());  }}

Patrones:

Arrange-Act-Assert
Evitar mocks parciales; preferir stubbing explícito
Usar @ParameterizedTest para variantes

Pruebas de Capa Web (MockMvc)

java

@WebMvcTest(MarketController.class)class MarketControllerTest {  @Autowired MockMvc mockMvc;  @MockBean MarketService marketService;
  @Test  void returnsMarkets() throws Exception {    when(marketService.list(any())).thenReturn(Page.empty());
    mockMvc.perform(get("/api/markets"))        .andExpect(status().isOk())        .andExpect(jsonPath("$.content").isArray());  }}

@WebMvcTest(MarketController.class)class MarketControllerTest {  @Autowired MockMvc mockMvc;  @MockBean MarketService marketService;
  @Test  void returnsMarkets() throws Exception {    when(marketService.list(any())).thenReturn(Page.empty());
    mockMvc.perform(get("/api/markets"))        .andExpect(status().isOk())        .andExpect(jsonPath("$.content").isArray());  }}

Pruebas de Integración (SpringBootTest)

java

@SpringBootTest@AutoConfigureMockMvc@ActiveProfiles("test")class MarketIntegrationTest {  @Autowired MockMvc mockMvc;
  @Test  void createsMarket() throws Exception {    mockMvc.perform(post("/api/markets")        .contentType(MediaType.APPLICATION_JSON)        .content("""          {"name":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}        """))      .andExpect(status().isCreated());  }}

@SpringBootTest@AutoConfigureMockMvc@ActiveProfiles("test")class MarketIntegrationTest {  @Autowired MockMvc mockMvc;
  @Test  void createsMarket() throws Exception {    mockMvc.perform(post("/api/markets")        .contentType(MediaType.APPLICATION_JSON)        .content("""          {"name":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}        """))      .andExpect(status().isCreated());  }}

Pruebas de Persistencia (DataJpaTest)

java

@DataJpaTest@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)@Import(TestContainersConfig.class)class MarketRepositoryTest {  @Autowired MarketRepository repo;
  @Test  void savesAndFinds() {    MarketEntity entity = new MarketEntity();    entity.setName("Test");    repo.save(entity);
    Optional<MarketEntity> found = repo.findByName("Test");    assertThat(found).isPresent();  }}

@DataJpaTest@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)@Import(TestContainersConfig.class)class MarketRepositoryTest {  @Autowired MarketRepository repo;
  @Test  void savesAndFinds() {    MarketEntity entity = new MarketEntity();    entity.setName("Test");    repo.save(entity);
    Optional<MarketEntity> found = repo.findByName("Test");    assertThat(found).isPresent();  }}

Testcontainers

Usar contenedores reutilizables para Postgres/Redis que reflejen producción
Conectar mediante @DynamicPropertySource para inyectar URLs JDBC en el contexto de Spring

Cobertura (JaCoCo)

Fragmento Maven:

xml

<plugin>  <groupId>org.jacoco</groupId>  <artifactId>jacoco-maven-plugin</artifactId>  <version>0.8.14</version>  <executions>    <execution>      <goals><goal>prepare-agent</goal></goals>    </execution>    <execution>      <id>report</id>      <phase>verify</phase>      <goals><goal>report</goal></goals>    </execution>  </executions></plugin>

<plugin>  <groupId>org.jacoco</groupId>  <artifactId>jacoco-maven-plugin</artifactId>  <version>0.8.14</version>  <executions>    <execution>      <goals><goal>prepare-agent</goal></goals>    </execution>    <execution>      <id>report</id>      <phase>verify</phase>      <goals><goal>report</goal></goals>    </execution>  </executions></plugin>

Aserciones

Preferir AssertJ (assertThat) para legibilidad
Para respuestas JSON, usar jsonPath
Para excepciones: assertThatThrownBy(...)

Builders de Datos de Prueba

java

class MarketBuilder {  private String name = "Test";  MarketBuilder withName(String name) { this.name = name; return this; }  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }}

class MarketBuilder {  private String name = "Test";  MarketBuilder withName(String name) { this.name = name; return this; }  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }}

Comandos de CI

Maven: mvn -T 4 test o mvn verify
Gradle: ./gradlew test jacocoTestReport

Recuerda: Mantener las pruebas rápidas, aisladas y deterministas. Probar comportamiento, no detalles de implementación.

來源與署名

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

授權條款：無授權條款

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

檢舉或申請下架

Springboot Tdd

Flujo de Trabajo TDD en Spring Boot

Cuándo Usar

Flujo de Trabajo

Pruebas Unitarias (JUnit 5 + Mockito)

Pruebas de Capa Web (MockMvc)

Pruebas de Integración (SpringBootTest)

Pruebas de Persistencia (DataJpaTest)

Testcontainers

Cobertura (JaCoCo)

Aserciones

Builders de Datos de Prueba

Comandos de CI

來源與署名

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

Vue Patterns

Uncloud

Team Agent Orchestration

Tasteforge Video

Taste

Social Publisher

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Testing Strategy

Tech Debt

System Design