테스트 하네스란? (Test Harness)

대현·2026년 6월 24일

CS Test Harness 테스트 하네스

⚙️소프트웨어 테스팅⚙️

목록 보기

1/1

테스트 하네스에 대해 정리해보고자 한다.

테스트 하네스(Test Harness)?

테스트 하네스는 테스트를 수행하기 위해 필요한
테스트 코드, 테스트 데이터, Stub, Driver, Mock, JUnit과 같은 테스트 실행 도구를 포함한
실행 환경 전체를 말한다.

처음에는 테스트 하네스라고 하면
그냥 JUnit 테스트 코드 정도를 의미하는 줄 알았다.

하지만 조금 더 찾아보고 정리해보니
테스트 하네스는 테스트 코드 하나만을 뜻하는 것이 아니었다.

테스트 대상 코드를 실행시키고,
필요한 입력을 넣고,
결과를 확인하고,
의존성을 대체하고,
테스트 결과를 수집할 수 있게 해주는 환경 전체에 가까웠다.

예를 들면 다음과 같은 것들이 테스트 하네스에 포함될 수 있다.

- 테스트 코드
- 테스트 데이터
- Stub
- Driver
- Mock
- JUnit
- Gradle
- 테스트 실행 스크립트
- 커버리지 측정 도구
- CI 환경

즉, 테스트 하네스는
"테스트를 가능하게 만드는 주변 장치들의 묶음"이라고 볼 수 있다.

그럼 테스트에 사용되는 모든 도구가 테스트 하네스일까?

여기서 조금 헷갈리는 부분이 생겼다.

테스트에 사용되는 모든 것을
테스트 하네스라고 할 수 있을까?

예를 들어 테스트 케이스를 뽑을 때
생성형 AI를 사용했다고 해보자.

그럼 이 생성형 AI도 테스트 하네스라고 할 수 있을까?

결론부터 말하면,
항상 그렇지는 않다.

생성형 AI를 단순히 옆에서 참고하는 도구로 사용했다면
테스트 하네스라고 보기는 어렵다.

예를 들면 이런 경우다.

"이 요구사항에서 테스트 케이스 뽑아줘"

"이 JUnit 테스트 코드 괜찮은지 봐줘"

"이 실패 로그 원인이 뭐야?"

이런 방식으로 사용했다면
AI는 테스트 환경 안에 포함된 구성 요소라기보다는
개발자가 외부에서 사용하는 보조 도구에 가깝다.

쉽게 말하면,
테스트를 직접 실행하거나
테스트 환경 안에서 자동으로 동작하는 것은 아니기 때문이다.

기준은 테스트 환경 안에 들어와 있는가이다

기준을 조금 더 명확하게 잡으면
이렇게 볼 수 있을 것 같다.

해당 도구가 테스트 실행 흐름 안에 직접 포함되어 있는가?

이 질문이 중요하다.

단순히 사람이 필요할 때마다 물어보는 도구라면
테스트 하네스라고 보기는 어렵다.

하지만 그 도구가 테스트 자동화 흐름 안에 들어와서
반복적으로 테스트 실행이나 결과 분석에 관여한다면
테스트 하네스의 일부로 볼 수 있다.

예를 들어 이런 흐름이 있다고 해보자.

테스트 실행
↓
실패 로그 수집
↓
AI Agent가 실패 원인 분석
↓
추가 테스트 케이스 제안
↓
개발자가 검토
↓
테스트 재실행

이 경우 AI Agent는 단순히 밖에서 조언만 하는 도구가 아니다.

테스트 workflow 안에서
실패 로그를 분석하고,
추가 테스트를 제안하고,
테스트 반복 과정에 참여한다.

이 정도로 테스트 환경 안에 통합되어 있다면
AI Agent도 테스트 하네스를 구성하는 하나의 보조 요소로 볼 수 있다.

API로 테스트 자동화 시스템에 연결했다면?

생성형 AI를 API로 연결해서
테스트 자동화 시스템 안에 넣었다면 이야기가 달라진다.

예를 들어 다음과 같은 시스템을 만들었다고 해보자.

1. GitHub Actions에서 테스트 실행
2. 실패 로그 자동 수집
3. AI API로 실패 원인 분석 요청
4. 분석 결과를 PR 코멘트로 작성
5. 커버리지 부족 부분에 대한 테스트 케이스 후보 생성

이 경우 AI는 단순히 사람이 따로 사용하는 도구가 아니다.

테스트 실행 흐름 안에서
자동으로 호출되고,
테스트 결과를 분석하고,
다음 행동에 영향을 준다.

이런 경우라면
생성형 AI도 테스트 하네스의 일부로 볼 수 있다.

정확히 말하면,
AI 자체가 테스트 하네스라기보다는
AI가 테스트 하네스를 구성하는 분석 보조 모듈로 포함된 것에 가깝다.

반대로 이런 경우는 테스트 하네스라고 보기 어렵다

반대로 다음과 같은 경우는
테스트 하네스라고 보기 어렵다.

- 블로그 글을 쓰기 위해 AI에게 개념 설명을 물어본 경우
- 테스트 케이스 아이디어를 한 번 참고한 경우
- 실패 로그를 복사해서 AI에게 수동으로 물어본 경우
- 코드 리뷰 느낌으로 AI에게 조언을 받은 경우

이 경우 AI는 테스트를 도와주기는 했지만,
테스트 실행 환경 안에 포함되어 있지는 않다.

즉, 테스트 하네스라기보다는
개발 보조 도구에 가깝다.

정리하면

테스트 하네스에 포함되는지 판단할 때는
다음 기준으로 보면 될 것 같다.

1. 테스트 실행 과정에 직접 포함되어 있는가?
2. 테스트 대상 코드와 상호작용하는가?
3. 테스트 입력, 실행, 검증, 결과 분석 중 하나를 담당하는가?
4. 반복 가능한 테스트 workflow 안에서 사용되는가?
5. 사람의 단순 참고용이 아니라 시스템의 일부로 동작하는가?

이 기준에 해당한다면
그 도구는 테스트 하네스의 일부로 볼 수 있다.

반대로 단순히 사람이 참고하기 위해 사용한 도구라면
테스트 하네스라고 보기 어렵다.