IT › 소프트웨어 › 테스트 › 테스트 레벨 · 유형

단위 테스트Unit Testing

단위 테스트는 클래스 · 함수 같은 작은 컴포넌트 하나를 다른 부분과 떼어, 개발자가 개발 환경에서 자동 테스트로 동작을 확인하는 테스트 단계다.

1요약

  1. 단위 테스트는 테스트 단계의 맨 아래에서 컴포넌트 하나를 떼어 개발자가 개발 환경에서 시험하는 단계로(ISTQB CTFL v4.0.1 2.2.1 · 「component testing」과 같은 말), JUnit(1997) · unittest 같은 xUnit 계열 프레임워크 위에서 커밋마다 돈다.
  2. 단위 테스트가 다른 테스트가 남긴 상태 · 시계 · 스레드에 기대면 같은 코드에서 통과와 실패가 오가는데, 오픈소스 51개 프로젝트의 불안정 테스트 수정 161건은 비동기 대기 45% · 동시성 20% · 테스트 순서 의존 12% 순이었고 126건은 처음 쓸 때부터 불안정했다(Luo 2014 3.1절).
  3. 「혼자 돌리면 통과, 함께 돌리면 실패」는 숨은 입력으로 가른다 — 순서를 바꿔 결과가 바뀌면 공유 상태, 날짜를 바꿔 바뀌면 시계, 같은 순서 · 같은 날에도 가끔 바뀌면 스레드 · 비동기 대기다.

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 맛볼 때마다 setUp 새 상태 앞 맛이 안 섞임 소스 한 냄비 2 냄비 하나만 시험 대상 단위 다른 냄비와 떼어 냄 레시피 비교 3 기준 맛 카드 기대값 · 단언 미리 적어 둔 맛 판정 4 맞음 · 틀림 ok · FAIL 혀 대신 단언이 판정 5 손님상 통합 · 시스템 통과한 소스만 섞음 요리사 개발자 고칠 때마다 직접 맛봄 타이머 10분 날짜 인자 「해 질 녘」 대신 쓴 숟가락 공유 상태 다시 넣으면 순서 탓

그림 1 · 요리사는 새 숟가락으로 냄비 하나만 떠서, 타이머로 고정한 조건에서 레시피 카드와 비교하고, 통과한 소스만 손님상으로 보낸다.

새 숟가락맛볼 때마다
한 냄비소스 하나만
타이머10분으로 고정
카드 비교적어 둔 기준 맛
판정통과한 소스만 상으로
비유 — 숟가락 하나로 두 냄비 실제 — 테스트 사이 상태 쓴 숟가락을 다시 넣음 앞 냄비의 짠맛이 남음 A B 먼저 본 냄비가 다음 맛을 바꿈 맛볼 때마다 새 숟가락 숟가락에 남는 맛이 없음 A B 어느 냄비를 먼저 봐도 같음 전역 _used 이름순 · 역순 모두 오류 1 뒤에 돈 테스트가 already used → ERROR(쿠폰 코드가 남음) 혼자 돌리면 둘 다 ok setUp 새 객체 두 순서 모두 OK 테스트마다 CouponBook 을 새로 만듦 → Ran 4 tests · OK 남는 상태가 없음 숟가락 = 테스트 사이에 남는 상태 · 냄비 A · B = 테스트 두 개

그림 2 · 쓴 숟가락을 다시 넣으면 먼저 맛본 냄비가 다음 맛을 바꾸듯, 테스트 사이에 남은 상태는 실행 순서에 따라 다른 테스트를 실패시킨다.

비유 속 역할실제 이름실제로 하는 일
소스 한 냄비시험 대상 단위클래스 · 함수 하나를 다른 부분과 떼어 시험한다
레시피 카드의 기준 맛기대값 · 단언결과를 미리 적은 값과 기계가 비교한다
맛볼 때마다 새 숟가락픽스처 · setUp테스트마다 새 상태를 만들어 앞 테스트의 흔적을 없앤다
쓴 숟가락 다시 넣기공유 상태 · 순서 의존전역 · 정적 값이 남아 실행 순서에 따라 결과가 바뀐다
「해 질 녘」 대신 타이머 10분날짜 인자 · 시계 주입결과를 바꾸는 시간을 테스트가 넘겨 언제 돌려도 같게 한다
요리사가 직접 맛봄개발자 · 개발 환경코드를 쓴 사람이 고칠 때마다 몇 초 안에 돌린다
손님상통합 · 시스템 테스트냄비끼리 섞인 뒤의 맛은 다음 단계가 본다

⚠ 비유가 맞지 않는 곳: 맛보기는 사람이 혀로 판정하지만 단위 테스트는 단언이 판정해 사람이 출력을 읽지 않아도 되고, 소스는 한 번 맛보면 끝이지만 테스트는 코드와 함께 남아 이후 모든 변경마다 다시 돈다.

4구조 — 시험 대상 단위와 고립 경계

단위 테스트는 공개 API 로만 단위를 부르고, 결과를 정하는 값은 모두 테스트가 인자로 넘긴다. DB · 망 · 파일 · 시계처럼 경계 밖에 있는 의존은 들이지 않고, 들여야 하면 인자로 주입하거나 테스트 더블로 바꾸거나 통합 테스트로 옮긴다(Feathers 2005 · Winters 2020 11장 작은 테스트).

테스트 케이스 준비 — 새 CouponBook 실행 — redeem() 호출 단언 — 결과 · 예외 동작 하나 = 테스트 하나 고립 경계 · 작은 테스트(한 프로세스) 공개 API · redeem() 시험 대상 단위 CouponBook · 사용 기록은 객체 안 명시 입력 code · total · today(인자) 호출 결과 경계 밖 — 들이지 않음 DB · 파일 망 · 원격 서비스 시계 · 난수 전역 · 정적 상태 경계 밖 의존 → 인자로 주입 · 테스트 더블로 대체 · 통합 테스트로 이동 테스트 · 판정 입구 · 입력 시험 대상 코드 경계 밖 의존(점선) 굵은 테두리 = 고립 경계

그림 3 · 테스트 케이스는 공개 API 로만 단위를 부르고, 결과를 정하는 입력은 모두 인자로 넘기며, 경계 밖 의존은 고립 경계 안으로 들이지 않는다.

요소역할값(사례)근거
테스트 케이스준비 · 실행 · 단언으로 동작 하나를 확인test_second_use_rejectedWake 2011 · Winters 2020 12장
공개 API테스트가 단위를 부르는 유일한 입구redeem(code, total, today)Winters 2020 12장
시험 대상 단위클래스 · 함수 하나(또는 작은 묶음)CouponBookCTFL 2.2.1
명시 입력결과를 정하는 값을 인자로 받음today=date(2027, 1, 1)사례 6단계
숨은 입력테스트가 넘기지 않았는데 결과를 바꿈모듈 전역 _used · date.today()Luo 2014 3.1절
픽스처테스트마다 새 상태를 만듦setUp() 의 새 CouponBookunittest 문서
러너 · 결과모아 실행하고 ok · FAIL · ERROR 로 보고Ran 4 tests … OKunittest 문서
경계 밖 의존단위 묶음에서 빼서 따로 둠DB · 망 · 파일Feathers 2005

5동작 — 일회용 쿠폰 함수의 순서 의존 사례

사례 = 직접 실행(Python 3.14.0 · 표준 라이브러리 unittest · python -m unittest -v). 규칙 셋 = 10% 할인 · 한 번만 사용 · 만료일 당일까지 유효(코드 WELCOME10 · 만료일 2026-12-31 · 설명용 가정 값).

  1. 첫 구현 — redeem(code, total) 은 사용 기록을 모듈 전역 집합 _used 에 두고 오늘 날짜를 date.today() 로 읽는다. 테스트 둘 = 「30,000원 → 27,000원」 · 「두 번째 사용은 ValueError」.
  2. 혼자 돌리기 — python -m unittest test_coupon.CouponTest.test_discount_10_percent 와 test_second_use_rejected 를 따로 돌리면 둘 다 Ran 1 test … OK 다.
  3. 함께 돌리기 — 이름순으로 할인 테스트가 먼저 돌아 _used 에 코드가 남고, 두 번째 테스트의 첫 redeem() 이 ValueError: already used 를 내 FAILED (errors=1) 이다.
  4. 순서 뒤집기 — 테스트 이름을 거꾸로 적어 돌리면 이번에는 할인 테스트가 ERROR 다. 실패하는 테스트가 순서를 따라 옮겨 다니므로 결함은 쿠폰 규칙이 아니라 테스트 사이 공유 상태다.
  5. 만료 규칙은 시험할 수 없음 — 함수가 date.today() 를 안에서 읽으므로 「2027-01-01 이면 거부」를 시험하려면 시스템 시계를 바꿔야 하고, 만료 전 통과 테스트는 2027-01-01 부터 저절로 실패한다.
  6. 설계 바꾸기 — 사용 기록을 CouponBook 객체 안으로, 날짜를 인자 today 로 옮기고 setUp() 이 테스트마다 새 객체를 만든다. 만료일 당일 통과 · 다음 날 거부 테스트 둘을 더해 4개다.
  7. 두 순서 모두 통과 — 이름순 · 역순 모두 Ran 4 tests … OK 다.
  8. 결함을 넣어 확인 — 만료 비교 today > 만료일 을 >= 로 바꾸면 test_last_day_accepted 하나만 ValueError: expired 로 FAILED (errors=1) 이 된다 — 날짜를 인자로 받게 한 뒤에야 하루 차이 결함을 잡는 테스트가 생겼다.
단계 실행 판 테스트 결과(실행 순) unittest 요약 2 할인 테스트 혼자 v1 Ran 1 · OK 재사용 테스트 혼자 v1 Ran 1 · OK 3 이름순 함께(할인 → 재사용) v1 errors=1 · already used 4 역순 함께(재사용 → 할인) v1 errors=1 · 할인 테스트 쪽 6 설계 바꿈 — 사용 기록은 객체 안 · 날짜는 인자 · setUp 이 새 객체 7 이름순 4개 v2 Ran 4 · OK 역순 4개 v2 Ran 4 · OK 8 만료 비교 > 를 >= 로 결함판 errors=1 · last_day 만 통과 오류(error · 단언 밖 예외) v1 = 전역 _used · date.today() / v2 = CouponBook · today 인자

그림 4 · 혼자서는 둘 다 통과하던 테스트가 함께 돌면 순서마다 다른 쪽이 오류였고, 상태를 객체 안으로 옮긴 뒤에는 두 순서 모두 통과하며 넣은 결함 하나만 잡았다.

🔑 단위 테스트의 결과는 테스트가 넘긴 값만으로 정해져야 한다 — 같은 코드에서 결과가 갈리면 코드보다 먼저 테스트가 읽는 숨은 입력을 찾는다.

불안정 테스트 수정 161건의 원인 단위 테스트 쪽 대책 비동기 대기 74건 · 45% sleep · 블로킹 호출 금지 동시성 32건 · 20% 한 프로세스 · 스레드 쓰지 않음 테스트 순서 의존 19건 · 12% setUp 으로 새 상태(수정의 74%) 자원 누수 11건 · 7% tearDown 으로 해제 망 10건 · 6% 경계 밖 · 통합 테스트로 시간 5건 · 3% 날짜 · 시각을 인자로 기타 12건 · IO · 난수 · 부동소수 등 입력 파일 · 난수 씨앗 고정 위 셋 = 77% — 셋 모두 테스트가 넘기지 않은 입력(시점 · 스레드 · 앞 테스트) 막대 길이 = 건수 · 한 건이 두 원인에 셀 수 있어 합 163 · 비율 = 161건 기준 · 대책 앞 표시 = 상위 셋

그림 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시험 대비

출제 정보 컴퓨터시스템응용(122회, 86회)문제 원문 — 큐넷 자료실 「기출문제(기술사)」 www.q-net.or.kr

시험에서는 단위 테스트의 정의 · 조건 · 고립형과 협력형을 묻는 정의 · 특징형과, 시험하기 어려운 코드를 테스트할 수 있게 바꾸고 불안정 테스트를 줄이는 방법을 묻는 구현 · 설계형이 나올 수 있다. 정의형은 고립 경계 그림과 비교표로, 설계형은 사례의 숨은 입력 제거 단계와 원인 분포 도표로 답안을 짠다.

답안 목차
  1. 개요 — 정의(CTFL 2.2.1 컴포넌트 테스트) · 테스트 단계에서의 위치 · IEEE 1008-1987 · xUnit(JUnit 1997)
  2. 조건 — FIRST(빠름 · 고립 · 반복 가능 · 자가 검증 · 적시) + Feathers 2005 조건 다섯 · 작은 테스트 제약
  3. 구조 — 그림 3 고립 경계(공개 API · 명시 입력 · 숨은 입력 · 경계 밖 의존) + 준비 · 실행 · 단언
  4. 적용 사례 — 그림 4 실행 결과(혼자 통과 · 함께 오류 · 역순 오류 → 객체 상태 · 날짜 인자 → 두 순서 통과)
  5. 불안정 테스트 대응 — 그림 5 원인 분포 막대 도표(45 · 20 · 12%) + 원인별 설계 대책
  6. 비교 · 운영 — 고립형 · 협력형 · 통합 비교표 · 테스트 비율 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참고 문헌

  1. 먼저 볼 문헌
  2. ★ ISTQB Certified Tester Foundation Level Syllabus v4.0.1 — 컴포넌트(단위) 테스트의 정의와 다른 테스트 단계와의 구분을 볼 때
    ISTQB · 2024-09 · www.istqb.org/certifications/certified-tester-foundation-level-ctfl-v4-0/ · 확인 2026-11-14
  3. ★ A Set of Unit Testing Rules (Michael Feathers · Artima Weblogs) — 단위 테스트로 보지 않는 테스트의 조건 다섯을 볼 때
    Artima · 2005-09 · www.artima.com/weblogs/viewpost.jsp?thread=126923 · 확인 2026-11-14
  4. ★ Unit Test (Martin Fowler bliki) — 고립형 · 협력형 단위 테스트와 classicist · mockist 구분을 볼 때
    Martin Fowler · 2014-05 · martinfowler.com/bliki/UnitTest.html · 확인 2026-11-14
  5. ★ Software Engineering at Google - Chapter 11 Testing Overview (Adam Bender · Winters · Manshreck · Wright) — 작은 · 중간 · 큰 테스트 크기의 제약과 테스트 비율 80 · 15 · 5 를 볼 때
    O'Reilly · 2020-03 · abseil.io/resources/swe-book/html/ch11.html · 확인 2026-11-14
  6. ★ An Empirical Analysis of Flaky Tests (Luo · Hariri · Eloussi · Marinov · FSE 2014) — 불안정 테스트 161건의 원인 분포와 고친 방법을 볼 때
    ACM · 2014-11 · mir.cs.illinois.edu/lamyaa/publications/fse14.pdf · 확인 2026-11-14
  7. 본문 근거
  8. 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
  9. IEEE 1008-1987 IEEE Standard for Software Unit Testing (superseded) — IEEE SA · 1986-12 · standards.ieee.org/ieee/1008/1462/ · 확인 2026-11-14
  10. Xunit (Martin Fowler bliki) — Martin Fowler · 2006-01 · martinfowler.com/bliki/Xunit.html · 확인 2026-11-14
  11. 3A - Arrange, Act, Assert (Bill Wake · XP123) — XP123 · 2011-04 · xp123.com/3a-arrange-act-assert/ · 확인 2026-11-14
  12. Python documentation - unittest: Unit testing framework — Python Software Foundation · 2026-11 · docs.python.org/3/library/unittest.html · 확인 2026-11-14