# [[Test Pyramid (테스트 피라미드)]]

## 📌 Brief Summary
테스트 피라미드(Test Pyramid)는 마이크 콘(Mike Cohn)이 고안한 개념으로, 소프트웨어 테스트를 다양한 세분화 수준(granularity)의 계층으로 분류하고 각 계층에서 수행해야 할 테스트의 적정 비율을 나타내는 시각적 메타포입니다 [1]. 하단에는 빠르고 작은 단위 테스트를 많이 배치하고, 상단으로 갈수록 범위가 넓고 느린 엔드투엔드(End-to-End) 테스트를 적게 배치해야 한다는 핵심 원칙을 제시합니다 [2]. 이를 통해 개발 팀은 빠르고 신뢰할 수 있으며 유지보수가 용이한 자동화된 테스트 제품군을 구축하여 소프트웨어 제공 속도와 품질을 높일 수 있습니다 [2, 3].

## 📖 Core Content
* **기본 원칙:** 테스트 피라미드는 두 가지 핵심 규칙을 따릅니다. 첫째, 다양한 세분화 수준을 가진 테스트를 작성해야 하며, 둘째, 상위 수준으로 올라갈수록 테스트의 수를 줄여야 합니다 [2].
* **단위 테스트 (Unit Tests):** 피라미드의 가장 아래층인 기반을 이루며 전체 자동화 테스트의 약 70%를 차지하는 것이 이상적입니다 [4]. 개별 컴포넌트나 함수가 의도한 대로 작동하는지 독립적으로 검증하며, 밀리초 단위로 실행될 만큼 빠르고 작성 및 유지보수 비용이 저렴합니다 [4, 5].
* **통합 테스트 (Integration Tests):** 피라미드의 중간 계층에 위치하며 약 20%의 비중을 갖습니다 [6]. 데이터베이스, 파일 시스템, 외부 API 등 애플리케이션 외부 요소와의 연동이 올바르게 이루어지는지 검증합니다 [7]. 단위 테스트보다는 느리지만, 개별 컴포넌트가 상호작용할 때 발생하는, 단위 테스트에서 잡을 수 없는 결함을 찾아내는 역할을 합니다 [6, 8].
* **엔드투엔드 테스트 (End-to-End Tests):** 피라미드의 최상단에 위치하며 약 10%의 비중을 차지해야 합니다 [9]. 실제 사용자의 여정을 시뮬레이션하여 사용자 인터페이스부터 백엔드 서비스까지 전체 시스템이 제대로 기능하는지 검증합니다 [9].
* **테스트 중복 방지와 하향 배치:** 상위 수준의 테스트가 오류를 발견했는데 하위 수준 테스트가 실패하지 않았다면 하위 수준의 테스트를 추가로 작성해야 합니다 [10]. 가능한 한 테스트를 피라미드의 가장 아래쪽으로 밀어내어 테스트 제품군의 실행 속도를 빠르고 간결하게 유지하는 것이 중요합니다 [10].

## ⚖️ Trade-offs & Caveats
* **역방향 테스트 피라미드 (Inverted Test Pyramid) 안티패턴:** 하향식(UI 도구 중심)으로 자동화 전략을 구축하면 피라미드가 역전되어 단위 테스트는 거의 없고 느리고 깨지기 쉬운 엔드투엔드 테스트만 수백 개 쌓이는 현상이 발생합니다 [9]. 이 안티패턴은 테스트 실행에 수 시간이 걸리게 만들어 빌드 빈도를 떨어뜨리고, 간헐적 실패(Flaky Tests)를 유발하여 결국 팀이 테스트 결과를 무시하게 만드는 부작용을 초래합니다 [9, 11].
* **상위 계층 테스트의 한계:** 엔드투엔드 및 UI 테스트는 구축 비용이 가장 비싸고, 실행 속도가 가장 느리며, 유지보수 측면에서 가장 깨지기 쉽습니다(brittle) [9, 12]. 따라서 하위 계층에서 이미 검증된 예외 케이스(edge cases)를 상위 계층에서 중복으로 테스트하는 것은 높은 유지보수 비용과 오탐(false positives)을 발생시키므로 피해야 합니다 [10, 12].
* **용어의 모호성과 오해:** 원래의 피라미드 모델에서 사용된 '서비스 테스트(Service Test)'나 'UI 테스트' 같은 용어는 현대의 소프트웨어 아키텍처(예: SPA 프레임워크) 환경에서 혼란을 줄 수 있습니다 [2]. 용어 자체에 얽매이기보다는 일관된 테스트 분류 체계를 팀 내에서 공유하고, 각 계층의 역할을 명확히 인지하는 것이 훨씬 중요합니다 [2, 13].

---
*Last updated: 2026-05-03*