consumer-driven contract testing이란 무엇인가요?

Question

IT Interview Practice · Accepted Answer

**contract testing(계약 테스트)**은 두 서비스를 완전한 통합 테스트로 함께 실행하지 **않고도** 그들이 API에 대해 합의했는지 검증합니다. **CDC(consumer-driven contracts, 소비자 주도 계약)**에서는 소비자가 필요한 것을 정의하고, 제공자가 그것을 제공할 수 있는지 검증합니다.

## 문제

많은 서비스에 걸친 완전한 종단 간(end-to-end) 테스트는 느리고, 불안정하며, 모든 커밋마다 실행하기 어렵습니다. 계약 테스트는 파괴적인 API 변경을 초기에, 격리된 상태로 잡아냅니다.

## CDC 동작 방식(예: Pact)

```text
1. 소비자가 기대치를 작성  ─▶ CONTRACT(Pact 파일) 생성
2. 계약을 브로커에 발행
3. 제공자가 자체 파이프라인에서 계약을 스스로에게 실행
4. 소비자를 깨뜨릴 경우 제공자 빌드가 실패
```

## 소비자 측 예시

```js
// 소비자가 제공자에게 기대하는 바를 정확히 선언
provider.given('order 42 exists')
  .uponReceiving('a request for order 42')
  .withRequest({ method: 'GET', path: '/orders/42' })
  .willRespondWith({
    status: 200,
    body: { id: '42', total: 99.5 } // 소비자가 의존하는 형태
  });
```

제공자의 CI가 이를 재생(replay)하고, 더 이상 그 형태를 반환하지 않으면 실패합니다.

## CDC vs 통합 테스트

| | 계약 테스트 | 통합 테스트 |
|---|---|---|
| 실행되는 서비스 | 한 번에 하나 | 모두 함께 |
| 속도 | 빠름 | 느림 |
| 잡아내는 것 | 계약 위반 | 실제 연결 문제 |

## 왜 중요한가

계약 테스트는 전체 시스템을 띄우는 비용과 불안정성 없이, 제공자 변경이 소비자를 깨뜨리지 않는다는 확신을 줍니다.

계약 테스트는 독립적 배포를 안전하게 만듭니다. 각 팀의 파이프라인은 자신의 변경이 누군가 의존하는 계약을 위반할 경우 즉시 알아챕니다.

	계약 테스트	통합 테스트
실행되는 서비스	한 번에 하나	모두 함께
속도	빠름	느림
잡아내는 것	계약 위반	실제 연결 문제

문제

CDC 동작 방식(예: Pact)

소비자 측 예시

관련 질문

CDC vs 통합 테스트

왜 중요한가