테스트 피라미드(testing pyramid)란 무엇인가요?

Question

Accepted Answer

**테스트 피라미드(testing pyramid)**는 테스트 스위트를 구조화하는 모델로, 바닥에 **빠른 단위 테스트를 많이**, 중간에 **integration test를 더 적게**, 꼭대기에 **end-to-end 테스트를 소수** 두는 것입니다. 균형 잡히고 효율적인 테스팅 전략을 안내합니다.

## 피라미드

```text
        /\
       /E2E\        ← end-to-end 테스트 소수 (느림, 넓음, 깨지기 쉬움, 비쌈)
      /------\
     / INTEG. \     ← integration test 일부 (중간 속도/범위)
    /----------\
   /   UNIT     \   ← unit 테스트 다수 (빠름, 집중적, 저렴) — 바닥
  /--------------\
```

```text
바닥(가장 많음): UNIT 테스트 — 빠르고, 격리되고, 저렴 → 많이 실행
중간: INTEGRATION 테스트 — 컴포넌트를 함께 → 더 적게 (느리고, 설정이 더 많음)
꼭대기(가장 적음): E2E 테스트 — 앱 전체, 사용자 흐름 → 소수 (느리고, 깨지기 쉽고, 비쌈)
```

## 왜 이런 모양인가

```text
✓ UNIT 테스트는 빠르고, 저렴하고, 신뢰할 수 있고, 실패를 짚어줌 → 많이 (토대)
✓ E2E 테스트는 느리고, 비싸고, 깨지기 쉬움(불안정, 디버깅 어려움) → 소수
  (중요한 흐름만)
✓ 균형: 빠른 피드백(많은 단위 테스트) + 전체가 동작한다는 자신감
  (일부 integration + 소수 E2E)
→ 대부분의 테스트는 빠른 단위 테스트여야 하며, 느린 E2E는 가장 중요한 흐름에만.
```

## 안티패턴

```text
✗ 아이스크림 콘(역전된 형태) → 대부분 느린 E2E/수동 테스트, 단위 테스트 소수 → 느리고,
  깨지기 쉽고, 비싼 테스트 스위트 (흔한 나쁜 패턴)
✗ 너무 많은 E2E 테스트 → 느린 CI, 불안정한 테스트, 유지보수 어려움
→ 피라미드 모양은 이런 것을 피한다.
```

## 왜 중요한가

테스트 피라미드를 이해하는 것은 **테스트 스위트를 효과적으로 구조화하는 데 핵심적인 지침**을 제공하므로 가치가 있으며, 건전한 테스팅 전략을 위한 중요한 지식입니다.

피라미드 모델 — **바닥에 빠른 단위 테스트 다수, 중간에 integration test 더 적게, 꼭대기에 end-to-end 테스트 소수** — 은 테스트 커버리지를 속도 및 유지보수성과 균형 잡는 핵심 원칙을 담고 있습니다.

**왜 이런 모양인지**를 이해하는 것이 핵심 통찰입니다. 단위 테스트는 빠르고, 저렴하고, 신뢰할 수 있고, 실패를 짚어주므로(토대로서 많이 두어야 함), 반면 E2E 테스트는 느리고, 비싸고, 깨지기 쉽고 불안정하므로(중요한 흐름에만 두어 소수로) — 빠른 피드백(많은 단위 테스트로부터)과 전체 시스템이 동작한다는 자신감(일부 integration과 소수 E2E로부터)을 모두 달성합니다.

이 균형이 테스트 스위트를 효과적이면서도 유지보수 가능하게 만듭니다.

**안티패턴**을 이해하는 것도 똑같이 가치가 있습니다. **"아이스크림 콘"**(역전된 피라미드, 대부분 느린 E2E와 수동 테스트에 단위 테스트가 적음)은 느리고, 깨지기 쉽고, 비싸고, 유지보수가 어려운 테스트 스위트를 만듭니다 — 피라미드가 피하도록 돕는 흔한 실제 실수입니다.

대부분의 테스트가 빠른 단위 테스트여야 하고(느린 E2E는 가장 중요한 흐름에만) 안다면, 빠른 피드백과 낮은 유지보수로 좋은 커버리지를 제공하는 테스트 스위트를 구축하는 데 도움이 됩니다.

테스트 스위트를 잘 구조화하는 것(커버리지, 속도, 유지보수성의 균형)이 효과적인 테스팅에 중요하고, 테스트 피라미드가 그 근거와 피해야 할 안티패턴과 함께 이를 안내하는 모델을 제공하므로, 테스트 피라미드를 이해하는 것은 가치 있고 실용적인 지식입니다. 이는 건전한 테스팅 전략의 기본 모델로서, 효율적이고 유지보수 가능한 테스트 스위트를 구축하고 느리고 깨지기 쉬운 상위 레벨 테스트에 과도하게 의존하는 흔한 실수를 피하도록 안내하며, 프로젝트가 소프트웨어를 어떻게 테스트할지 설계하는 누구에게나 중요합니다.