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)
• 부분 목(partial mock)은 피하고 명시적 스터빙을 선호합니다
• 다양한 입력 조합은 @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를 통해 Spring 컨텍스트에 JDBC URL을 주입합니다

커버리지 (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

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