화이트박스 테스트White-box Testing
코드의 제어 흐름 · 데이터 흐름을 근거로 테스트 케이스를 설계하고, 문장 · 분기 · 경로 같은 구조 요소가 얼마나 실행됐는지로 충분함을 재는 테스트 기법 분류다.
1요약
- 화이트박스 테스트는 코드를 제어 흐름 그래프(CFG) 로 모델링해 문장 · 분기 · 조건 · 경로 · 데이터 흐름을 커버리지 항목으로 삼는 기법 분류이고, ISO/IEC/IEEE 29119-4:2021 이 구조 기반 기법 7개로, ISTQB CTFL v4.0.1 이 문장 · 분기 두 기법으로 정리한다.
- NIST SP 500-235(1996)의 「count」 모듈은 문장 · 분기 기준을 2건으로 채우고도 결함을 놓쳤고, 순환 복잡도 5 만큼 독립 경로를 시험하자 어떤 경로 집합으로도 결함이 드러났다(5.4절).
- 「커버리지 100% 인데 결함」은 케이스 수와 v(G) 로 가른다 — 케이스가 v(G)보다 적으면 경로 조합 누락, v(G) 만큼인데 계획한 경로를 탈 입력이 없으면 결정끼리 묶인 코드 구조, 둘 다 아니면 만들지 않은 요구라 명세 기반 시험이 다룬다.
2등장 배경
명세만 보고 고른 시험 데이터는 자주 쓰는 길을 되풀이한다. NIST SP 500-235 는 실행 시간의 50% 가 코드 4% 에 몰린다는 Knuth 조사를 들어, 요구사항 관점의 케이스가 같은 문장 몇 개만 반복 실행한다고 적었다(5.1절).
1976년 12월 Thomas McCabe 가 결정 논리의 양을 재는 순환 복잡도 v(G) 를 발표했고(McCabe 1976), Glenford Myers 는 1979년 문장 · 결정 · 조건 · 다중 조건 커버리지를 케이스 설계 기준으로 묶었다(Myers 1979). 1985년 4월 Rapps · Weyuker 는 변수의 정의와 사용을 잇는 데이터 흐름 기준을 내놓았고(Rapps 1985), 1996년 8월 NIST SP 500-235 가 v(G) 개의 독립 경로를 시험하는 구조적 테스트(기본 경로 테스트)를 지침으로 냈다.
지금은 ISTQB CTFL v4.0.1(2024-09)이 문장 · 분기 테스트를 기본으로 가르치고 MC/DC 같은 엄격한 기법은 안전 필수 분야 몫으로 둔다(4.3절). 기법 전체의 분류와 MC/DC 계산은 「테스트 기법」이 맡고, 화이트박스 테스트는 CFG · 순환 복잡도 · 기본 경로 · 데이터 흐름을 다룬다.
3쉽게 이해하기 — 배관 물감 점검
배관공 한 기사가 새 건물 배관을 넘겨받기 전에 도면을 편다. 갈림 밸브는 둘 — 무거운 짐 통로와 산간 배송 통로다. 물감 탄 물을 두 번 흘리니 모든 관에 자국이 묻었지만, 도면의 고리를 세어 보니 따로 흘려 볼 물길은 셋이었다. 남은 물길을 흘리자 물이 계획과 다른 관으로 갔고, 두 밸브가 손잡이 하나에 묶여 있었다.
그림 1 · 물감 자국이 모든 관을 덮어도 물길을 고리 수만큼 따로 흘려야 묶인 밸브가 드러난다.
그림 2 · 자국은 관마다 한 번만 보지만 물길은 고리 수만큼 따로 보므로, 묶인 밸브는 물길 쪽에서만 걸린다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 한 기사 | 테스터 | 코드 구조를 보고 케이스를 설계한다 |
| 배관 도면 | 제어 흐름 그래프(CFG) | 문장 묶음 = 노드, 제어 이동 = 간선으로 그린다 |
| 갈림 밸브 둘 | 결정(3 · 5행) | 조건의 참 · 거짓으로 흐름을 나눈다 |
| 물감 자국 | 커버리지 계측 | 실행된 문장 · 분기를 기록한다 |
| 모든 관에 자국 | 분기 커버리지 100% | 결정 결과 4개를 모두 한 번 이상 실행한다 |
| 고리 세기 | 순환 복잡도 v(G) | 독립 경로 수를 e − n + 2 로 센다 |
| 따로 흘린 물길 셋 | 기본 경로 테스트 | v(G) 만큼 독립 경로를 실행한다 |
| 한 손잡이에 묶인 밸브 | 같은 조건을 두 번 쓴 결함 | 계획한 경로가 실행되지 않아 드러난다 |
⚠ 비유가 맞지 않는 곳: 배관은 물길이 유한하지만 반복문이 있는 코드는 경로 수가 무한이라 «모든 경로»를 시험할 수 없고(NIST SP 500-235 5.1), 기본 경로는 그 가운데 독립인 v(G) 개만 고른다.
4구조 — 제어 흐름 그래프와 순환 복잡도
설명용 가정 값의 함수 ship_days(weight, remote) 다. 명세는 「기본 1일, 무게 20kg 초과면 2일, 산간 지역이면 2일 더함」이고, 5행은 3행을 복사한 뒤 조건을 고치지 않은 결함이다.
def ship_days(weight, remote):
days = 1
if weight > 20:
days = 2
if weight > 20: # 명세는 remote
days = days + 2
return days
그림 3 · 결정 노드 둘이 노드 6 · 간선 7 의 흐름을 만들고, v(G) = 3 이 시험할 독립 경로 수를 정한다.
| 요소 | 정의 | 사례 값 | 근거 |
|---|---|---|---|
| 노드 | 끊김 없이 이어지는 문장 묶음 | 6개(2 · 3 · 4 · 5 · 6 · 7행) | NIST 2.1 |
| 간선 | 노드 사이 제어 이동 | 7개 | CTFL 4.3.2 |
| 결정 노드 | 나가는 간선이 둘인 노드 | 3행 · 5행 | NIST 4.1 |
| v(G) | 독립 경로 수 = e − n + 2 | 3 | NIST 2.2 |
| 기본 경로 집합 | 다른 모든 경로를 선형 조합으로 만드는 경로 v(G) 개 | 3참·5참 · 3거짓·5참 · 3참·5거짓 | NIST 2.3 · 5.1 |
| 정의 · 사용 쌍 | 변수에 값을 넣은 곳 → 그 값을 읽는 곳 | days 2행 → 6 · 7행 | Rapps 1985 |
5동작 — 배송일 함수의 문장 · 분기 · 기본 경로 시험
Python 3.14.0 표준 라이브러리 sys.settrace 로 입력마다 실행된 줄을 기록했다(직접 실행 · 입력은 설명용 가정 값).
- 명세에서 기대값을 정한다 — (25kg, 산간) 4일 · (10kg, 일반) 1일 · (10kg, 산간) 3일 · (25kg, 일반) 2일.
- 코드를 CFG 로 그려 노드 6 · 간선 7 · v(G) = 3 을 얻는다(NIST 2.2절).
- 문장 커버리지 — (25, True) 1건이 2 ~ 7행 6문장을 모두 실행하고 4일로 통과한다(CTFL 4.3.1).
- 분기 커버리지 — (10, False) 를 더하면 결정 결과 4개(3행 참 · 거짓, 5행 참 · 거짓)가 모두 실행돼 100% 이고 1일로 통과한다(CTFL 4.3.2).
- 기준 경로 방법 — 기준 경로 3참·5참에서 결정을 하나씩 바꿔 3거짓·5참 → (10, True), 3참·5거짓 → (25, False) 를 만든다(NIST 6.1절).
- 두 건 모두 실패한다 — (10, True) 기대 3 · 실제 1, (25, False) 기대 2 · 실제 4. 실행 기록은 계획과 달리 2 → 3 → 5 → 7, 2 → 3 → 4 → 5 → 6 → 7 이었다.
- 5행을
if remote:로 고치고 4건을 다시 돌리면 모두 통과하고, 네 경로가 모두 실행된다.
그림 4 · 분기 100% 의 2건은 통과하고, 기본 경로가 더한 2건은 계획한 경로를 타지 못해 실패한다.
그림 5 · 경로 넷 가운데 셋이 독립이고 넷째는 그 조합이라, 어떤 기본 경로 집합도 결함이 보이는 경로를 하나 이상 지난다.
🔑 분기 커버리지는 결정 «결과»를 하나씩 세고 기본 경로는 결과의 «조합»을 독립인 만큼 세므로, 결정끼리 엮인 결함은 기본 경로 쪽에서만 걸린다.
6비교 — 구조 기반 기준 다섯
| 기준 | 커버리지 항목 | 사례 최소 건수 | 사례 결함 | 강점 |
|---|---|---|---|---|
| 문장 | 실행 문장 | 1건 | 놓침 | 안 쓰인 코드 발견(CTFL 4.3.1) |
| 분기(결정) | 결정 결과 | 2건 | 놓침 | 문장 기준 포함(CTFL 4.3.2) |
| MC/DC | 조건마다 결정을 홀로 바꾸는 쌍 | 2건(조건이 하나뿐인 결정) | 놓침 | 복합 조건 논리 오류(NASA/TM-2001-210876) |
| 기본 경로 | 독립 경로 v(G) 개 | 3건 | 찾음 | 분기 기준 포함 · 건수가 복잡도에 비례(NIST 5.2) |
| 데이터 흐름(all-uses) | 정의 · 사용 쌍 | 2건 + 실행 불가 쌍 2개(손분석) | 찾음 — remote 가 정의만 되고 쓰이지 않음 | 값이 엉뚱한 곳에 쓰이는 결함(Rapps 1985) |
분석결정이 조건 하나씩이면 분기 다음 단계로 기본 경로를, 복합 조건이 많으면 MC/DC 를, 값의 흐름이 길면 데이터 흐름을 더한다. 근거는 표의 「사례 결함」 열에서 조건이 하나뿐인 결정에서는 MC/DC 가 분기와 같아지고, 기본 경로와 데이터 흐름만 결함을 잡았다는 점이다.
블랙박스 테스트와의 차이는 케이스의 근거(명세 ↔ 코드)이고, 두 분류의 비교는 「테스트 기법」이 맡는다.
7실무 진단 — 구조 시험의 빈틈 가르기
분석케이스 수를 v(G) 와 먼저 맞춰 보고, 모자라면 경로를 더하고, 채웠는데 계획한 경로를 탈 입력이 없으면 코드 구조를 의심한다. 기본 경로 기준은 v(G) 개의 독립 경로를 요구하고 실행 불가 경로는 결정끼리의 의존을 뜻하기 때문이다(NIST SP 500-235 5.1절).
| # | 증상 | 의심 원인 | 구분 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 분기 100% 인데 특정 입력 조합만 실패 | 경로 조합 누락 | 기본 경로 | 함수별 v(G) ↔ 케이스 수 | 독립 경로 케이스 ≥ v(G)(NIST 5.1) |
| 2 | 계획한 경로를 탈 입력이 없음 | 같은 결정 되풀이 · 결정끼리 의존 | 기본 경로 | python -m trace --trace 로 입력별 실행 줄 확인 | 계획 ≠ 실제 경로면 구조 결함 신호 · 못 고치면 실제 복잡도로 낮춤(NIST 5.1 · 9.1) |
| 3 | 한 함수에 결함 · 수정이 몰림 | 결정 논리 과다 | 복잡도 | 정적 분석 도구의 함수별 v(G) | 10 초과면 함수를 나누거나 시험을 늘림(NIST 2.5) |
| 4 | 인자 값이 결과에 반영되지 않음 | 정의만 되고 쓰이지 않는 변수 | 데이터 흐름 | 정의 · 사용 쌍 목록 · 미사용 인자 경고 | 모든 정의가 사용 하나 이상으로 이어져야 함(Rapps 1985) |
1 · 3행은 도구 보고서로 바로 보고, 2행은 1행에서 더한 케이스가 실패했을 때 실행 줄 기록으로 원인을 가른다. 4행은 코드 리뷰 때 먼저 볼 수 있어 실행 전에도 쓴다(CTFL 4.3.3 정적 시험).
8시험 대비
www.q-net.or.kr시험에서는 화이트박스 테스트의 개념 · 커버리지 기준을 묻는 정의 · 특징형과 블랙박스 테스트와 근거 · 장단점을 견주는 비교형이 나올 수 있다. 정의 · 특징형은 CFG 한 장과 v(G) 계산을 넣고, 비교형은 «근거 · 커버리지 항목 · 놓치는 결함» 세 축 표로 쓰면 다른 답안과 차이가 난다.
- 개요 — 정의 · 근거 = 코드 구조(제어 흐름 · 데이터 흐름) · 블랙박스와 근거 차이
- 모델 — 그림 3 CFG(노드 6 · 간선 7) · v(G) = e − n + 2 = 3 · 결정 + 1
- 기준 — 문장 · 분기 · MC/DC · 기본 경로 · 데이터 흐름 비교표(커버리지 항목 · 최소 건수)
- 적용 사례 — 그림 4 케이스 1 → 2 → 3건 · 기준 경로 방법이 더한 2건 실패
- 핵심 원리 — 그림 5 경로 넷 중 독립 셋 · 분기 100% 가 경로 조합을 보장하지 않는 이유
- 한계와 보완 — 누락 결함은 못 찾음(CTFL 4.3.3) · 명세 기반 병행 · 복잡도 10 기준
꼭 쓸 키워드
제어 흐름 그래프순환 복잡도기본 경로 테스트기준 경로 방법문장 커버리지분기 커버리지데이터 흐름 테스트정의-사용 쌍실행 불가 경로
9오해와 사실
- 오해분기 커버리지 100% 면 모든 경로를 시험한 것이다.사실분기 기준은 결정 결과를 하나씩만 요구해 사례에서 경로 넷 중 둘만 실행했고, 반복문이 있으면 경로 수는 무한이라 기본 경로도 독립인 v(G) 개만 고른다(NIST SP 500-235 5.1절).
- 오해순환 복잡도는 필요한 테스트 수의 상한이다.사실v(G) 는 기본 경로 기준을 채우는 최소 건수이고, 분기 기준은 그보다 적은 건수로도 채워진다(NIST SP 500-235 5.2절).
- 오해화이트박스 테스트는 코드를 실행해야만 할 수 있다.사실CFG 로 모델링할 수 있는 의사 코드 · 실행 전 코드도 손으로 따라가는 정적 시험에 쓴다(CTFL 4.3.3).
10핵심 정리
| 용어 | 구분 | 세는 것 | 사례 값 | 근거 |
|---|---|---|---|---|
| 제어 흐름 그래프 | 모델 | 노드 · 간선 | 노드 6 · 간선 7 | NIST 2.1 |
| 순환 복잡도 v(G) | 지표 | e − n + 2 · 결정 + 1 | 3 | NIST 2.2 · 4.1 |
| 문장 커버리지 | 기준 | 실행 문장 ÷ 전체 | 1건 · 6 / 6 | CTFL 4.3.1 |
| 분기 커버리지 | 기준 | 실행 분기 ÷ 전체 | 2건 · 4 / 4 | CTFL 4.3.2 |
| 기본 경로 테스트 | 기준 · 기법 | 독립 경로 | 3건 · 2건 실패 | NIST 5.1 · 6.1 |
| 데이터 흐름 테스트 | 기준 · 기법 | 정의 · 사용 쌍 | remote 미사용 | Rapps 1985 |
| 실행 불가 경로 | 진단 신호 | 입력으로 못 타는 경로 | 3거짓·5참 | NIST 5.1 · 9.1 |
11참고 문헌
- 먼저 볼 문헌
- ★ NIST Special Publication 500-235 Structured Testing: A Testing Methodology Using the Cyclomatic Complexity Metric (Watson · McCabe) — v(G) = e − n + 2 · 기본 경로 기준 · 기준 경로 방법 · 복잡도 한계 10 을 원문으로 볼 때
- ★ ISTQB Certified Tester Foundation Level Syllabus v4.0.1 — 문장 · 분기 커버리지의 정의와 화이트박스 테스트의 강점 · 한계(4.3절)를 무료 원문으로 볼 때
- ★ A Complexity Measure (T. McCabe · IEEE Transactions on Software Engineering SE-2(4)) — 순환 복잡도를 처음 정의한 논문의 서지를 볼 때
- ★ Selecting Software Test Data Using Data Flow Information (S. Rapps · E. Weyuker · IEEE Transactions on Software Engineering SE-11(4) 367-375) — 정의 · 사용 쌍으로 케이스를 고르는 데이터 흐름 기준의 출발점을 볼 때
- 본문 근거
- ISO/IEC/IEEE 29119-4:2021 Software and systems engineering - Software testing - Part 4: Test techniques — ISO/IEC/IEEE · 2021-10 ·
webstore.iec.ch/publication/71836· 확인 2026-11-14 - NASA/TM-2001-210876 A Practical Tutorial on Modified Condition/Decision Coverage — NASA · 2001-05 ·
ntrs.nasa.gov/citations/20010057789· 확인 2026-11-14 - The Art of Software Testing, 3rd Edition (1st Edition 1979) — John Wiley & Sons · 2011-11 ·
www.oreilly.com/library/view/the-art-of/9781118133156/· 확인 2026-11-14 - Python documentation - trace: Trace or track Python statement execution — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/trace.html· 확인 2026-11-14 - Python documentation - sys.settrace — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/sys.html#sys.settrace· 확인 2026-11-14