springboot-tdd

Spring Boot TDD 워크플로우

Spring Boot 서비스를 위한 TDD 가이드, 80% 이상의 커버리지(단위 + 통합)를 목표로 합니다.

사용 시점

• 새 기능 또는 엔드포인트 추가
• 버그 수정 또는 리팩토링
• 데이터 접근 로직 또는 보안 규칙 추가

워크플로우

1. 먼저 테스트를 작성합니다(실패해야 함)
2. 테스트를 통과할 최소한의 코드를 구현합니다
3. 테스트가 통과된 상태에서 리팩토링합니다
4. 커버리지를 확인합니다(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)
• 부분 Mock은 피하고 명시적 Stubbing을 선호
• 다양한 입력에 대해 @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>

단언문(Assertions)

• 가독성을 위해 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

기억하세요: 테스트는 빠르고, 격리되어 있으며, 결정적이어야 합니다. 구현 세부 사항이 아닌 동작을 테스트하세요.