1. 통과하는 테스트 뒤에 숨어 있던 것들
Summary
AI가 양산한 2,199개의 Mock 지옥에서 단 4개만 남기고 탈출한 비결
통합 테스트 환경 구축부터 골든 마스터 기법까지, 흔들리지 않는 튼튼한 테스트 코드를 만드는 실무 가이드
AI 에이전트와 함께 작성하며 폭발적으로 증가한 Mock 테스트의 실체를 파헤치고 이를 구조적으로 해결한 실무 전환 과정을 소개합니다. Testcontainers와 WireMock을 활용해 포트 충돌 없이 격리된 통합 테스트 인프라를 손쉽게 구축한 노하우를 공유합니다. 나아가 계산 오차를 1원 단위까지 감지하는 특성화 테스트 기법과 기록형 Mock 설계를 통해 레거시 코드를 안전하게 리팩토링하는 여정을 생생히 보여줍니다.
- 01AI 에이전트의 단일 파일 편향 및 테스트 패스 완료 조건에 따른 Mock 무한 증식의 자기강화 루프 현상 규명
- 02Testcontainers(MySQL)와 WireMock 동적 포트 매핑을 통해 충돌 걱정 없는 멀티 워커 병렬 통합 테스트 환경 구축
- 03구현에 종속적인 toHaveBeenCalled 검증 대신 계약에 묶인 전송 페이로드 중심의 기록형 Mock 도입
- 04리팩토링 과정에서 소수점 오차 및 음수 경계값까지 빈틈없이 체크하는 특성화 테스트(Golden Master) 스냅샷 설계
- 05CI 빌드를 무력화하던 777건의 테스트 코드 lint 기술 부채를 소거해 강건한 빌드 수문장 게이트웨이 마련
RECOMMENDATION
AI 코딩 도구를 적용한 후 늘어나는 테스트 유지보수 비용으로 고통받거나, 작은 구현 변경에도 수많은 Mock 단언문이 깨져 스트레스를 받는 백엔드 엔지니어 및 테크 리드에게 일독을 강력히 권장합니다.
The Problem
어필리에이트 서비스의 3개 TypeScript 백엔드 서버에서 통합 테스트가 전혀 없는 상황에서 테스트 작성을 AI 에이전트에 의존한 결과, 무분별하게 Mock이 양산되어 최대 2,199개까지 증가했습니다. 이로 인해 사소한 시그니처 변경에도 무관한 테스트들이 깨지고, 실제 입출력 값 검증 대신 단순 호출 여부만 검증하는 취약한 구조가 고착화되었습니다.
The Solution
Testcontainers와 WireMock을 도입하여 실제 운영 환경과 유사한 격리된 통합 테스트 환경을 구축했습니다. DB 연동 로직은 통합 테스트로 검증하고, 외부 프로세스 경계는 호출 횟수가 아닌 송신 페이로드를 검증하는 기록형 Mock으로 전환하였으며, 리팩토링 안정성을 담보하기 위해 대량의 금액 계산 조합을 스냅샷으로 동결하는 특성화 테스트(Golden Master)를 구현했습니다.
The Result
정교한 테스트 인프라 구축과 점진적인 전환 작업을 거쳐 Mock의 개수를 기존 2,199개에서 단 4개로 대폭 축소하는 데 성공했습니다. 더불어 테스트 코드 내의 777건의 lint 규칙 위반 부채를 전량 해결하여 정상적인 CI 게이트를 복구하였고 계산 로직 변경 시의 미세한 오차도 원천적으로 차단할 수 있게 되었습니다.
Trade-off
실제 도커 컨테이너를 띄워 DB 및 외부 API 스텁을 검증하므로, 순수 메모리 기반의 유닛 테스트에 비해 초기 인프라 설정 비용이 크고 로컬 및 CI 파이프라인상에서의 전체 테스트 실행 시간이 소폭 증가할 수 있습니다. 또한 현재의 결과값을 그대로 스냅샷화하는 특성화 테스트 방식의 특성상 기존 코드 내에 존재하던 잠재적 버그까지 정상 스펙으로 오인하여 동결시킬 수 있으므로 면밀한 검증 검토가 동반되어야 합니다.
