Spring Boot TDD 工作流程 是做什麼的？
針對 Spring Boot 服務的 TDD 指引，目標達到 80% 以上覆蓋率（單元 + 整合）。
使用時機
- 新增功能或端點
- 修復錯誤或重構
- 新增資料存取邏輯或安全規則
工作流程
- 先撰寫測試（測試應該失敗）
- 實作最小程式碼讓測試通過
- 在測試通過的情況下重構
- 強制覆蓋率標準（JaCoCo）
單元測試（JUnit 5 + Mockito）
@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());
}
}
模式：
- Arrange-Act-Assert
- 避免部分模擬；偏好明確的 stub
- 使用
@ParameterizedTest處理變體
網頁層測試（MockMvc）
@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());
}
}
整合測試（SpringBootTest）
@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());
}
}
持久層測試（DataJpaTest）
@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
- 使用可重複使用的容器來模擬 Postgres/Redis 以貼近生產環境
- 透過
@DynamicPropertySource將 JDBC URL 注入 Spring 上下文
覆蓋率（JaCoCo）
Maven 設定片段：
<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>
斷言
- 偏好使用 AssertJ 的
assertThat以提高可讀性 - 對於 JSON 回應，使用
jsonPath - 對於例外處理：
assertThatThrownBy(...)
測試資料建構器
class MarketBuilder {
private String name = "Test";
MarketBuilder withName(String name) { this.name = name; return this; }
Market build() { return new Market(null, name, MarketStatus.ACTIVE); }
}
CI 指令
- Maven：
mvn -T 4 test或mvn verify - Gradle：
./gradlew test jacocoTestReport
請記住：保持測試快速、隔離且可預測。測試行為，而非實作細節。