단위 테스트Unit Testing
단위 테스트는 클래스 · 함수 같은 작은 컴포넌트 하나를 다른 부분과 떼어, 개발자가 개발 환경에서 자동 테스트로 동작을 확인하는 테스트 단계다.
1요약
- 단위 테스트는 테스트 단계의 맨 아래에서 컴포넌트 하나를 떼어 개발자가 개발 환경에서 시험하는 단계로(ISTQB CTFL v4.0.1 2.2.1 · 「component testing」과 같은 말), JUnit(1997) ·
unittest같은 xUnit 계열 프레임워크 위에서 커밋마다 돈다. - 단위 테스트가 다른 테스트가 남긴 상태 · 시계 · 스레드에 기대면 같은 코드에서 통과와 실패가 오가는데, 오픈소스 51개 프로젝트의 불안정 테스트 수정 161건은 비동기 대기 45% · 동시성 20% · 테스트 순서 의존 12% 순이었고 126건은 처음 쓸 때부터 불안정했다(Luo 2014 3.1절).
- 「혼자 돌리면 통과, 함께 돌리면 실패」는 숨은 입력으로 가른다 — 순서를 바꿔 결과가 바뀌면 공유 상태, 날짜를 바꿔 바뀌면 시계, 같은 순서 · 같은 날에도 가끔 바뀌면 스레드 · 비동기 대기다.
2등장 배경
모듈을 다 짠 뒤 한꺼번에 이어 붙여 시험하면, 실패가 났을 때 수십 개 모듈 가운데 어디가 원인인지 찾는 데 시간이 든다. IEEE 는 1986년 12월 승인한 IEEE 1008-1987 에서 단위의 요구 · 설계 정보로 시험 완료를 판정하는 단계 · 활동 · 작업 위계를 정했다(IEEE 1008-1987 · 지금은 superseded).
1997년 Kent Beck 과 Erich Gamma 가 취리히에서 OOPSLA 로 가는 비행기에서 JUnit 을 짜면서 단위 테스트는 문서 절차에서 개발자가 코드로 쓰고 바로 돌리는 일로 바뀌었고, CppUnit 을 시작으로 거의 모든 언어에 xUnit 포트가 생겼다(Fowler 2006). 2005년 Michael Feathers 는 DB · 망 · 파일 시스템을 건드리거나 다른 단위 테스트와 동시에 돌 수 없는 테스트는 단위 테스트가 아니라는 조건 다섯을 적었다(Feathers 2005).
지금 단위 테스트는 CI 의 첫 관문이다. Google 은 테스트 수 기준 단위 약 80% · 통합 15% · 종단 간 5% 를 권하고(Winters 2020 11장), Jay Fields 가 이름 붙인 고립형(solitary) · 협력형(sociable) 구분이 «단위가 어디까지인가»를 가르는 말로 쓰인다(Fowler 2014).
3쉽게 이해하기 — 저녁 장사 전 소스 한 냄비 맛보기
식당 주방에서 요리사가 저녁 장사 전에 소스 냄비 하나만 따로 떠서 맛본다. 레시피 카드에 적힌 기준 맛과 비교하고, 맛볼 때마다 새 숟가락을 쓴다. 쓴 숟가락을 다음 냄비에 넣으면 앞 소스 맛이 섞여 어느 냄비를 먼저 봤는지에 따라 맛이 달라지기 때문이다. 끓이는 시간도 「해 질 녘까지」가 아니라 타이머 10분으로 정해 두어, 언제 맛봐도 같은 맛이 나온다.
그림 1 · 요리사는 새 숟가락으로 냄비 하나만 떠서, 타이머로 고정한 조건에서 레시피 카드와 비교하고, 통과한 소스만 손님상으로 보낸다.
그림 2 · 쓴 숟가락을 다시 넣으면 먼저 맛본 냄비가 다음 맛을 바꾸듯, 테스트 사이에 남은 상태는 실행 순서에 따라 다른 테스트를 실패시킨다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 소스 한 냄비 | 시험 대상 단위 | 클래스 · 함수 하나를 다른 부분과 떼어 시험한다 |
| 레시피 카드의 기준 맛 | 기대값 · 단언 | 결과를 미리 적은 값과 기계가 비교한다 |
| 맛볼 때마다 새 숟가락 | 픽스처 · setUp | 테스트마다 새 상태를 만들어 앞 테스트의 흔적을 없앤다 |
| 쓴 숟가락 다시 넣기 | 공유 상태 · 순서 의존 | 전역 · 정적 값이 남아 실행 순서에 따라 결과가 바뀐다 |
| 「해 질 녘」 대신 타이머 10분 | 날짜 인자 · 시계 주입 | 결과를 바꾸는 시간을 테스트가 넘겨 언제 돌려도 같게 한다 |
| 요리사가 직접 맛봄 | 개발자 · 개발 환경 | 코드를 쓴 사람이 고칠 때마다 몇 초 안에 돌린다 |
| 손님상 | 통합 · 시스템 테스트 | 냄비끼리 섞인 뒤의 맛은 다음 단계가 본다 |
⚠ 비유가 맞지 않는 곳: 맛보기는 사람이 혀로 판정하지만 단위 테스트는 단언이 판정해 사람이 출력을 읽지 않아도 되고, 소스는 한 번 맛보면 끝이지만 테스트는 코드와 함께 남아 이후 모든 변경마다 다시 돈다.
4구조 — 시험 대상 단위와 고립 경계
단위 테스트는 공개 API 로만 단위를 부르고, 결과를 정하는 값은 모두 테스트가 인자로 넘긴다. DB · 망 · 파일 · 시계처럼 경계 밖에 있는 의존은 들이지 않고, 들여야 하면 인자로 주입하거나 테스트 더블로 바꾸거나 통합 테스트로 옮긴다(Feathers 2005 · Winters 2020 11장 작은 테스트).
그림 3 · 테스트 케이스는 공개 API 로만 단위를 부르고, 결과를 정하는 입력은 모두 인자로 넘기며, 경계 밖 의존은 고립 경계 안으로 들이지 않는다.
| 요소 | 역할 | 값(사례) | 근거 |
|---|---|---|---|
| 테스트 케이스 | 준비 · 실행 · 단언으로 동작 하나를 확인 | test_second_use_rejected | Wake 2011 · Winters 2020 12장 |
| 공개 API | 테스트가 단위를 부르는 유일한 입구 | redeem(code, total, today) | Winters 2020 12장 |
| 시험 대상 단위 | 클래스 · 함수 하나(또는 작은 묶음) | CouponBook | CTFL 2.2.1 |
| 명시 입력 | 결과를 정하는 값을 인자로 받음 | today=date(2027, 1, 1) | 사례 6단계 |
| 숨은 입력 | 테스트가 넘기지 않았는데 결과를 바꿈 | 모듈 전역 _used · date.today() | Luo 2014 3.1절 |
| 픽스처 | 테스트마다 새 상태를 만듦 | setUp() 의 새 CouponBook | unittest 문서 |
| 러너 · 결과 | 모아 실행하고 ok · FAIL · ERROR 로 보고 | Ran 4 tests … OK | unittest 문서 |
| 경계 밖 의존 | 단위 묶음에서 빼서 따로 둠 | DB · 망 · 파일 | Feathers 2005 |
5동작 — 일회용 쿠폰 함수의 순서 의존 사례
사례 = 직접 실행(Python 3.14.0 · 표준 라이브러리 unittest · python -m unittest -v). 규칙 셋 = 10% 할인 · 한 번만 사용 · 만료일 당일까지 유효(코드 WELCOME10 · 만료일 2026-12-31 · 설명용 가정 값).
- 첫 구현 —
redeem(code, total)은 사용 기록을 모듈 전역 집합_used에 두고 오늘 날짜를date.today()로 읽는다. 테스트 둘 = 「30,000원 → 27,000원」 · 「두 번째 사용은ValueError」. - 혼자 돌리기 —
python -m unittest test_coupon.와CouponTest. test_discount_10_percent test_second_use_rejected를 따로 돌리면 둘 다Ran 1 test … OK다. - 함께 돌리기 — 이름순으로 할인 테스트가 먼저 돌아
_used에 코드가 남고, 두 번째 테스트의 첫redeem()이ValueError: already used를 내FAILED (errors=1)이다. - 순서 뒤집기 — 테스트 이름을 거꾸로 적어 돌리면 이번에는 할인 테스트가
ERROR다. 실패하는 테스트가 순서를 따라 옮겨 다니므로 결함은 쿠폰 규칙이 아니라 테스트 사이 공유 상태다. - 만료 규칙은 시험할 수 없음 — 함수가
date.today()를 안에서 읽으므로 「2027-01-01 이면 거부」를 시험하려면 시스템 시계를 바꿔야 하고, 만료 전 통과 테스트는 2027-01-01 부터 저절로 실패한다. - 설계 바꾸기 — 사용 기록을
CouponBook객체 안으로, 날짜를 인자today로 옮기고setUp()이 테스트마다 새 객체를 만든다. 만료일 당일 통과 · 다음 날 거부 테스트 둘을 더해 4개다. - 두 순서 모두 통과 — 이름순 · 역순 모두
Ran 4 tests … OK다. - 결함을 넣어 확인 — 만료 비교
today > 만료일을>=로 바꾸면test_last_day_accepted하나만ValueError: expired로FAILED (errors=1)이 된다 — 날짜를 인자로 받게 한 뒤에야 하루 차이 결함을 잡는 테스트가 생겼다.
그림 4 · 혼자서는 둘 다 통과하던 테스트가 함께 돌면 순서마다 다른 쪽이 오류였고, 상태를 객체 안으로 옮긴 뒤에는 두 순서 모두 통과하며 넣은 결함 하나만 잡았다.
🔑 단위 테스트의 결과는 테스트가 넘긴 값만으로 정해져야 한다 — 같은 코드에서 결과가 갈리면 코드보다 먼저 테스트가 읽는 숨은 입력을 찾는다.
그림 5 · 불안정 테스트 원인 상위 셋(77%)은 모두 테스트가 넘기지 않은 입력이고, 단위 테스트 설계 규칙이 원인마다 그 입력을 막는다.
🔑 「작은 테스트」 제약(한 프로세스 · sleep · I/O · 망 금지)은 원인 상위 둘이 들어올 길을 구조로 막고, 셋째인 순서 의존은 테스트마다 새 상태를 만드는 픽스처가 막는다.
6비교 — 고립형 · 협력형 단위 테스트와 컴포넌트 통합 테스트
| 기준 | 고립형(solitary) | 협력형(sociable) | 컴포넌트 통합 테스트 |
|---|---|---|---|
| 협력 객체 | 테스트 더블로 바꿈 | 빠르고 결정적인 실제 객체를 씀 | 실제 컴포넌트를 이음 |
| 실패가 가리키는 곳 | 시험 대상 하나 | 대상 + 협력 객체 | 컴포넌트 사이 인터페이스(CTFL 2.2.1) |
| 리팩터링 뒤 깨짐 | 호출 검증이 많으면 잦음(Winters 2020 12장) | 공개 동작이 같으면 드묾 | 인터페이스가 바뀔 때 |
| 테스트 크기 | 작은 테스트 | 작은 테스트 | 중간(localhost 까지 · Winters 2020 11장) |
| 따르는 쪽 | mockist(Fowler 2014) | classicist(Fowler 2014) | 통합 전략(상향 · 하향 · 빅뱅 · CTFL 2.2.1) |
분석단위 테스트는 협력형으로 쓰고 원격 서비스처럼 다루기 어려운 협력 객체만 더블로 바꾸며, 실제 DB · 망이 있어야 하는 시험은 통합 테스트로 옮긴다. 근거는 표의 「리팩터링 뒤 깨짐」 행과, 빠르고 결정적인 실제 객체를 mock 보다 먼저 쓰라는 Winters 2020 12장이다.
7실무 진단 — 불안정 단위 테스트의 원인 가르기
분석실패한 테스트를 혼자 다시 돌리는 것부터 한다. 혼자 통과하면 순서 · 공유 상태를, 혼자서도 가끔 실패하면 시계 · 스레드 · 대기를 보는데, 순서 의존 수정의 74% 가 테스트 사이 공유 상태 정리였다(Luo 2014 F.10).
| # | 증상 | 의심 원인 | 구분 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 묶음으로는 실패 · 혼자는 통과 | 전역 · 정적 값이 남음 | 순서 의존 | python -m unittest <모듈>. 단독 · 이름을 역순으로 나열 | 순서를 바꿔 실패 테스트가 옮겨 가면 공유 상태(Luo 2014 3.1.3 · 사례 4단계) |
| 2 | 특정 날짜 · 시각에만 실패 | 단위가 안에서 시계를 읽음 | 시간 | 시험 대상 코드의 date.today() · time.time() 호출 검색 | 날짜를 인자로 받게 바꾼 뒤 고정 날짜로 통과(사례 6단계) |
| 3 | 같은 순서에서도 가끔 실패 | sleep 으로 비동기 결과를 기다림 · 스레드 경쟁 | 비동기 · 동시성 | 테스트의 sleep( 호출 · 같은 테스트 반복 실행 결과 | 작은 테스트는 sleep · 블로킹 호출 금지(Winters 2020 11장) |
| 4 | 단위 묶음이 수 분씩 걸림 | DB · 파일 · 망을 실제로 부름 | 경계 위반 | 테스트 파일의 open( · connect( 호출 검색 | 그런 테스트는 단위 묶음과 따로 둔다(Feathers 2005) |
단독 실행부터 하는 까닭은 한 번의 실행으로 순서 의존(1행)과 나머지(2 ~ 3행)가 갈리기 때문이다. 1 ~ 3행이 아니면서 느리기만 하면 4행으로 경계를 넘은 테스트를 찾아 통합 묶음으로 옮긴다.
8시험 대비
www.q-net.or.kr시험에서는 단위 테스트의 정의 · 조건 · 고립형과 협력형을 묻는 정의 · 특징형과, 시험하기 어려운 코드를 테스트할 수 있게 바꾸고 불안정 테스트를 줄이는 방법을 묻는 구현 · 설계형이 나올 수 있다. 정의형은 고립 경계 그림과 비교표로, 설계형은 사례의 숨은 입력 제거 단계와 원인 분포 도표로 답안을 짠다.
- 개요 — 정의(CTFL 2.2.1 컴포넌트 테스트) · 테스트 단계에서의 위치 · IEEE 1008-1987 · xUnit(JUnit 1997)
- 조건 — FIRST(빠름 · 고립 · 반복 가능 · 자가 검증 · 적시) + Feathers 2005 조건 다섯 · 작은 테스트 제약
- 구조 — 그림 3 고립 경계(공개 API · 명시 입력 · 숨은 입력 · 경계 밖 의존) + 준비 · 실행 · 단언
- 적용 사례 — 그림 4 실행 결과(혼자 통과 · 함께 오류 · 역순 오류 → 객체 상태 · 날짜 인자 → 두 순서 통과)
- 불안정 테스트 대응 — 그림 5 원인 분포 막대 도표(45 · 20 · 12%) + 원인별 설계 대책
- 비교 · 운영 — 고립형 · 협력형 · 통합 비교표 · 테스트 비율 80 · 15 · 5% · CI 첫 관문
꼭 쓸 키워드
컴포넌트 테스트xUnit준비실행단언테스트 픽스처고립형협력형FIRST불안정 테스트테스트 순서 의존의존성 주입
다른 답안과 차이를 내는 한 가지는 FIRST 의 «반복 가능»을 구호로 두지 않고, 불안정 테스트 161건의 원인 비율(45 · 20 · 12%)과 원인별 설계 대책을 짝지어 적는 것이다.
9오해와 사실
- 오해단위는 메서드 하나다.사실단위는 보장하는 동작 하나를 기준으로 고르며, 한 테스트가 여러 메서드를 부르거나 한 메서드를 여러 테스트가 나눠 볼 수 있다(Winters 2020 12장 「test behaviors, not methods」).
- 오해협력 객체를 모두 mock 으로 바꿔야 단위 테스트다.사실실제 협력 객체를 쓰는 협력형도 단위 테스트이고, 초기 xUnit 테스트는 협력이 어려운 경우가 아니면 이 방식이었다(Fowler 2014).
- 오해다시 돌려 통과하면 불안정 테스트는 해결된 것이다.사실재실행은 원인을 뒤로 미룰 뿐이고, 불안정률이 1% 에 가까워지면 테스트가 값을 잃기 시작한다(Winters 2020 11장).
10핵심 정리
| 구분 | 맡는 일 | 사례 값 | 어기면 생기는 일 | 확인 방법 | 근거 |
|---|---|---|---|---|---|
| 시험 대상 단위 | 동작 하나를 내는 클래스 · 함수 | CouponBook | 실패 위치를 못 좁힘 | 실패 보고가 한 클래스를 가리키나 | CTFL 2.2.1 |
| 명시 입력 | 결과를 정하는 값은 인자로 | today=date(2027, 1, 1) | 날짜마다 결과가 바뀜 | 단위 안에 date.today() 없음 | 사례 6단계 |
| 픽스처 | 테스트마다 새 상태 | setUp() 의 새 객체 | 순서 의존(12%) | 역순 실행 결과가 같음 | Luo 2014 |
| 준비 · 실행 · 단언 | 테스트 하나 = 동작 하나 | 할인 · 재사용 · 당일 · 만료 4개 | 실패 원인이 여럿 섞임 | 실행 줄이 하나 | Wake 2011 |
| 작은 테스트 | 한 프로세스 · sleep · I/O 없음 | 외부 호출 0 | 비동기 대기(45%) · 동시성(20%) | 망 · 파일 호출 검색 | Winters 2020 11장 |
| 불안정 테스트 | 같은 코드에서 결과가 갈림 | v1 이름순 · 역순 각 errors=1 | 실패를 무시해 실제 결함을 놓침 | 단독 · 역순 · 반복 실행 | Luo 2014 |
| 고립형 · 협력형 | 협력 객체를 바꾸나 두나 | 실제 객체 유지(협력형) | 리팩터링마다 깨짐(과한 더블) | 공개 API · 상태만 검증 | Fowler 2014 |
11참고 문헌
- 먼저 볼 문헌
- ★ ISTQB Certified Tester Foundation Level Syllabus v4.0.1 — 컴포넌트(단위) 테스트의 정의와 다른 테스트 단계와의 구분을 볼 때
- ★ A Set of Unit Testing Rules (Michael Feathers · Artima Weblogs) — 단위 테스트로 보지 않는 테스트의 조건 다섯을 볼 때
- ★ Unit Test (Martin Fowler bliki) — 고립형 · 협력형 단위 테스트와 classicist · mockist 구분을 볼 때
- ★ Software Engineering at Google - Chapter 11 Testing Overview (Adam Bender · Winters · Manshreck · Wright) — 작은 · 중간 · 큰 테스트 크기의 제약과 테스트 비율 80 · 15 · 5 를 볼 때
- ★ An Empirical Analysis of Flaky Tests (Luo · Hariri · Eloussi · Marinov · FSE 2014) — 불안정 테스트 161건의 원인 분포와 고친 방법을 볼 때
- 본문 근거
- Software Engineering at Google - Chapter 12 Unit Testing (Erik Kuefler · Winters · Manshreck · Wright) — O'Reilly · 2020-03 ·
abseil.io/resources/swe-book/html/ch12.html· 확인 2026-11-14 - IEEE 1008-1987 IEEE Standard for Software Unit Testing (superseded) — IEEE SA · 1986-12 ·
standards.ieee.org/ieee/1008/1462/· 확인 2026-11-14 - Xunit (Martin Fowler bliki) — Martin Fowler · 2006-01 ·
martinfowler.com/bliki/Xunit.html· 확인 2026-11-14 - 3A - Arrange, Act, Assert (Bill Wake · XP123) — XP123 · 2011-04 ·
xp123.com/3a-arrange-act-assert/· 확인 2026-11-14 - Python documentation - unittest: Unit testing framework — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/unittest.html· 확인 2026-11-14