integration test(통합 테스트)란 무엇인가요?

Question

Accepted Answer

**integration test(통합 테스트)**는 여러 **컴포넌트나 unit이 함께 올바르게 동작하는지** 검증합니다 — 상호작용과 통합 지점(코드와 데이터베이스, 서로 호출하는 서비스, 결합된 모듈 등)을 테스트합니다. unit을 격리하는 단위 테스트가 놓치는 문제를 포착합니다.

## integration test가 검증하는 것

```text
integration test는 격리가 아닌, 함께 동작하는 컴포넌트를 검증한다:
  → 코드 + 데이터베이스 (데이터 계층이 실제 DB와 정말 동작하는가?)
  → 서비스 A가 서비스 B / 외부 API를 호출
  → 결합된 여러 모듈/unit; 그것들 사이의 통합 지점
→ 부분들이 어떻게 상호작용하는지에서의 문제 포착 — 격리된 단위 테스트가 못 잡는 것.
```

## integration test가 중요한 이유 (단위 테스트 대비)

```text
단위 테스트는 unit을 격리(의존성 mocking) → 빠르지만 실제 통합을 검증하지 못함:
  → unit이 자체 테스트는 통과해도 결합 시 실패할 수 있음 (의존성에 대한 잘못된 가정,
    잘못된 실제 DB 쿼리, API 계약 불일치, 설정 문제)
integration test는 실제(또는 현실적) 의존성을 사용 → 이런 상호작용 버그 포착:
  → 배선/설정 오류, 데이터 계층 문제, 컴포넌트 간 계약 불일치
→ integration test는 부분들이 실제로 함께 동작하는지 검증한다.
```

## 예시와 고려사항

```js
// integration test: 리포지토리가 (테스트) 데이터베이스와 실제로 동작
test('UserRepository saves and retrieves a user', async () => {
  const repo = new UserRepository(testDb);     // 실제 테스트 데이터베이스
  await repo.save({ name: 'Ann' });
  const user = await repo.findByName('Ann');    // 실제 쿼리
  expect(user.name).toBe('Ann');
});
```

```text
→ 단위 테스트보다 느림 (실제 I/O, 설정); 테스트 데이터베이스/환경 사용
→ 중요한 통합 지점 테스트 (데이터 액세스, 핵심 서비스 상호작용, API)
→ 단위 테스트보다 적게 (피라미드 중간); 테스트 데이터/상태를 신중히 관리
```

## 왜 중요한가

integration test를 이해하는 것은 중요합니다. 이는 단위 테스트가 **포착할 수 없는 종류의 버그** — 컴포넌트가 함께 동작하는 방식의 문제 — 를 포착하므로, 포괄적인 테스팅을 위한 가치 있는 지식입니다.

단위 테스트는 개별 unit을 격리 상태로 검증하지만(의존성 mocking), 이 격리는 곧 **실제 통합을 검증할 수 없음**을 의미합니다. unit이 모든 자체 테스트를 통과해도 실제로 다른 것들과 결합되면 실패할 수 있습니다(의존성에 대한 잘못된 가정, 잘못된 실제 데이터베이스 쿼리, API 계약 불일치, 설정 문제 때문). **integration test**는 **실제(또는 현실적) 의존성으로 컴포넌트가 함께 동작하는지** 테스트하여 이 틈새를 메웁니다 — 코드가 실제 데이터베이스와 정말 동작하는지, 서비스가 올바르게 상호작용하는지, 통합 지점이 작동하는지 검증하여, 격리된 단위 테스트가 놓치는 배선, 데이터 계층, 계약 버그를 포착합니다.

이 상호보완적 관계(격리된 로직을 위한 단위 테스트, 실제 상호작용을 위한 integration test)를 이해하는 것이 포괄적 테스팅의 핵심입니다. 둘 중 하나만으로는 충분하지 않기 때문입니다.

**고려사항** — integration test가 더 느리고(실제 I/O와 설정으로, 피라미드 중간에 위치하며 단위 테스트보다 적음), 테스트 데이터베이스/환경을 사용하고, 중요한 통합 지점(데이터 액세스, 핵심 서비스 상호작용, API)에 집중하며, 신중한 테스트 데이터/상태 관리를 요한다는 점 — 을 이해하는 것은 실용적인 integration test를 반영합니다.

integration test는 조립된 부분들이 동작한다는 자신감을 제공하며, 이는 단위 테스트만으로는 줄 수 없습니다.

실제 애플리케이션은 상호작용하는 컴포넌트로 구성되고 통합 버그(데이터베이스 문제, 계약 불일치, 설정 오류)는 흔하며 단위 테스트가 놓치고, integration test가 컴포넌트가 함께 동작하는지 검증하여 그것들을 포착하므로, integration test를 이해하는 것은 가치 있고 실용적인 지식입니다. 이는 상호작용 버그를 포착하는 단위 테스트의 필수 보완으로, 격리된 unit뿐 아니라 시스템의 부분들이 실제로 올바르게 함께 동작하는지 검증하는 포괄적 테스팅에 중요합니다.